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ComfilePi 


The ComfilePi is a touch panel PC designed with high-tolerant components and no moving 
parts for industrial applications. It features a water-resistant front panel, touchscreen, 
color LCD (available in various sizes), RS-232, RS-485, Ethernet, USB, I2C, SPI, digital IO, 

battery-backed RTC (real-time clock), and piezo buzzer. 


Use the rear-panel 40-pin GPIO header to expand its features and capabilities with additional 
I/O boards. The ComfilePi is UL Listed and employs Raspberry Pi Compute Module. 
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Visit www.comfiletech.com © copyright COMFILE Technology, Inc. ALL RIGHTS RESERVED TECHNOLOGY 


WELCOME 


aspberry Pi 5 is out now! This is a landmark event 


to The MagP1 135 
for Raspberry Pi as it brings speed parity with 


R traditional desktop computers. 


That you get all that speed and power in a tiny single- 
board computer is nothing short of miraculous. And we 
can’t wait to see what you make with it. Our Launch 
Special starts on page 36. 

We’ve also got 50 Raspberry Pi project ideas starting on 
page 70. If you’re thinking of something to make with your 
shiny new Raspberry Pi 5, this feature is sure to fire some 
brain cells. 

We can’t wait to see what you make with Raspberry Pi 5. 
So please remember to share your creations (big or small) 
with us using #MagPiMonday on social media. Or, email us 
directly: magpi@raspberrypi.com. We always love to hear 
from you! 


Lucy Hattersley Editor 
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Lucy 
Hattersley 


Lucy is editor of 
The MagPi and has 
been making retro 
synthpop in the 
Welsh countryside 
for the last few 
weeks. Ideas for 
her synthpop 
band name ona 
postcard, please! 
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Raspberry Pi 5| 
PRIORITY BOARDING 


FIRST! 


We've reserved Raspberry Pi 5 boards 
for The MagPi subscribers 


New subscribers to The MagPi will get a Priority Boarding 
code when they sign up. So don't delay. Take out a 
subscription today! You'll be able to buy your Raspberry Pi 5 
first and get incredible Raspberry Pi tutorials, projects, and 
community events every month. 


magpi.cc/priorityboarding 


TERMS & CONDITIONS A Priority Boarding code will be emailed to everybody who takes out a print subscription to The 
MagPi or HackSpace magazine. People who subscribe to both magazines will get two codes. Print subs only! Priority 
Boarding does not apply to people with App Store, Google Play, Zinio, PDF contributions, or other paid-for subscriptions. Each 
code will entitle you to purchase 1x (one) Raspberry Pi 5 model (either 4 GB or 8 GB) for the standard retail price and delivery. 
Multiple codes need to be used individually. This is a limited offer and is subject to change or withdrawal at any time. 
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DISCLAIMER: Some ofthe tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations covering 
many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your jurisdiction 
and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go beyond. It is 
your responsibility to understand the manufacturer's limits. 
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We have over 400,900 new, name-brand products 
in stock and ready to ship-with more added daily. 
If you can design it, we can help you build it. 


Find what you need at digikey.co.uk/new 
or call 0800 587 6991 


DigiKey is a franchised distributor for all supplier partners. New products added daily. DigiKey and DigiKey Electronics are registered trademarks of DigiKey Electronics in the U.S. and 
other countries. © 2023 DigiKey Electronics, 701 Brooks Ave. South, Thief River Falls, MN 56701, USA 
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à Final components are put 
into the boards using robot 
arms that have entirely pre- 
programmed movements 


Where Raspberry Pis 


The Sony factory in Wales is where Raspberry Pi 
and its accessories come to life. By Rob Zwetsloot 


encoed is not a big town, having a 

population of under 10,000. However, big 

things come out of there. It’s where you’ll 
find the Sony UK Technology Centre, one part 
factory where the vast majority of Raspberry Pis 
are made, alongside other products such as Sony 
broadcast cameras, and also where Sony supports 
tech startups, prototyping, and code clubs. 

We were lucky to be given a tour of the facilities 
where machines, robot arms, and real people make 
250,000 Raspberry Pi computers a week - from 
board to box. Have you ever seen a machine put 
a little computer in a box? It’s very cute, and 
the mechanism to fold the lid is a very simple 
Sheets of naked Raspberry Pi 4, ready to be assembled angled piece of metal that runs along the line, 
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maintaining the key engineering philosophy of 
KISS (keep it super-simple, as our friends at the 
Raspberry Pi Foundation like to say it). 


Eco friendly 
A (rightful) concern of many people is the 
environmental impact of manufacturing products, 
and a key part of the operation of the Pencoed 
site is meeting sustainability targets which are set 
every five years. From using more green energy to 
reducing waste of all kinds, Sony is taking active 
steps towards reducing its environmental impact. 

You can see this along the lines, with (human- 
supervised) automated checks to make sure all 
chips are installed correctly. Misaligned chips can 
usually be reset which cuts down on waste and 
overall improve yield, and the reflow soldering 
methods (described in our engineering interview in 
The MagPi 134: magpi.cc/134) in the new Raspberry 
Pi 5 manufacturing process (referred to by a 
codename of Hydrogen in the factory) that also 
improve the number of working boards. 

The factory floor itself is divided up into areas 
with clear signs on what section is which. On one 


Factory tour video 


Want to see the factory for yourself? Jeff Geerling 
has a great video of his tour of the factory with even 
more excellent visuals: magpi.cc/tour. 


MägPi 


Each board is tested 
before being packed 
using this fantastic 
Sony machine 


We were lucky to be given a tour of the 
facilities where machines, robot arms, and 
real people make 250,000 Raspberry Pi 
computers a week 


station you’ll have someone building a broadcast 
camera from scratch, with two a week going out 
the doors, and in another section you’ll have 
people snapping boards off runners to be fed into 
the boxing machine. The complexity is impressive 
to behold, with a lot of custom machines built 
and maintained by Sony to make the humble 
Raspberry Pi. 


People are trained 
on how to make 
Raspberry Pi 
thoroughly before 
heading to the 
factory floor 
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Blackberry P1 


The BlackBerry is back - or at least that's what David Crookes 
thought until he looked more closely at Zhou Xu's amazing creation 


Zhou is an electron 
microscope 
scientist working at 
Monash University 
in Australia. He also 
describes himself 
as a maker, 3D 
printing nerd, and 
LEGO MOCer. 


magpi.cc/bbpi 


> Zhou gathered all 
of the components 
together before 
considering the 
design of the case 


10 | magpicc | Blackberry Pi 


entered the fray, when BlackBerry 

smartphones were all the rage. They were 
introduced in 1999 and, at their peak in 2011, 
attracted more than 85 million users. From 
that point on, however, it was all downhill as 
BlackBerry’s big selling points - the physical 
keyboard and email service - gave way to 
touchscreens and rival alternatives. 


Tee was a time, before Apple and Google 


Even so, there’s still something rather 
charming about BlackBerry handsets and, for 
anyone wanting to do some serious computing 
on-the-go, tapping away on physical keys 
remains more comfortable. For those reasons, it’s 
hard not to be enthused about Zhou Xu’s amazing 
project. It allows Linux software to run via a 
Raspberry Pi Zero W computer on a 320x240 LCD 
screen and it’s controllable using a BlackBerry- 
style keyboard. 

“The idea started from my Game Boy Zero Plus 
build that was based on a stripped Raspberry 
Pi 3A computer,” Zhou explains, referring to a 
project in which a new Game Boy handheld was 
built by inserting a thinned-down Raspberry Pi 
3A into an original case. “After completing it, 

I decided that I would then love to make use of 
Raspberry Piin a handheld format for testing 
and debugging in the field. But I did not have a 
clear plan for the keyboard design until I recently 
found the BBQ20KBD from Solder Party.” 


Key components 
The BBQ20KBD is a QWERTY keyboard and 
optical track pad device powered by an RP2040 
microcontroller. Identical to the BB Q20 used 
in the BlackBerry Classic released in 2014, the 
tiny set of keys is placed onto a custom-printed 
circuit board and, because it has a USB Type-C 
socket, it’s easy to hook up to Raspberry Pi. 

The keyboard gave Zhou’s Blackberry Pia 
strong direction. “The design was heavily inspired 
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Running Raspberry Pi = = - i ~ Quick FACTS 
OS, the device boots . - x 


in the command-line > The project uses 


interface by default an upcycled 
BlackBerry 
keyboard 
: + © > The NNQ20KBD 


Ra Ti< 5 : keyboards cost just 
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[S S7 T I ENT > BlackBerry Pi 
is designed for 
by many other Raspberry Pi handheld projects, potential future 
such as Beepy and ClockworkPi,” he adds. There expansion 
were some other requirements. “One of the aims 
for this design was to test an SDR radio antenna 


in my backyard. A battery-powered handheld is 
so much easier for this job,” he says. 


> External devices 
may need an add- 
on battery pack 


Zhou chose a 2500 mAh LiPo battery, as well as > The STL and STEP 
an Adafruit PowerBoost 1000C power supply. He files are at: 
also took a GearBest 3.5 composite LCD display magpi.cc/bbpi3D 


out of his Game Boy Zero Plus build, and added 

a Raspberry Pi Camera Module 2 NoIR. Of all the 
components, though, selecting to use a Raspberry 
Pi Zero W was the easiest decision. 

“T started playing with Raspberry Pi with the 
original version so I’m very comfortable tinkering 
4 The case was designed in SolidWorks, a 3D CAD with the config files and soldering the pins,” 

package for Windows that dates back to 1995! Zhou says. “Even though many Raspberry Pi 


Blackberry Pi | magpi.cc | 11 


EE Magri | PROJECT SHOWCASE 


4 The main components 
sit behind the screen 
There is a 5V fan for 
cooling too 
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models were still out of stock at the time when I 
started this project, I still wanted to use one (and 
Pll be upgrading to Raspberry Pi Zero 2 W). I find 
the comprehensive documentation provided by 
Raspberry Pi is so much more useful than starting 
from scratch on the other counterparts.” 


Mod man 

Rather than use an existing case to fit the 
components, Zhou felt he would have much 

more control if he designed his own. As such, 

he drafted a case using the 3D CAD package 
SolidWorks, with the aim of outputting the design 
to his Creality Ender-3 3D printer. 

“Ever since my Game Boy project, I find it so 
much easier to build things from the ground up,” 
he explains. “Modding an existing enclosure can 
take quite some extra effort and I’m now getting 
more confident in CADing. 


“Besides, if I’d have used an existing 
BlackBerry case, squeezing the components 
in there would be very challenging. That said, 
recently I’ve started to teach myself to use KiCad 
for designing customised PCBs. Perhaps it would 
be possible to make one that fits in a BlackBerry 
case using a [Raspberry] Pi Compute Module 4.” 
Not that the project is any worse for having 
a freshly designed case. In fact, it looks 
amazing, made all the prettier by having the 
classic rainbow stripes as seen on the Sinclair 
ZX Spectrum from 1982. “That was a bit of a 
random decision,” Zhou says. “ZX matches 
my initials and I’ve always liked retro- 
style designs.” 


Clever case 

A lot of thought went into the case. “I’m pretty 
proud to point out that all the GPIO pins are 
accessible from the top of the screen and I 


m Ever since my Game Boy 
project, | find it so much 
easier to build things from 
the ground up @ 


have added a few peripheral mounting points 
around the enclosure for future add-ons such 

as [Raspberry] Pi HATs,” Zhou adds. “I’m also 
very excited about the outcome of the enclosure 
printing. This was the first time I have ever 
played with the six-colour manual change on my 
Klipperised Ender-3 printer.” 

It nevertheless proved very challenging. 

“T spent quite some time trying to optimise 
the arrangement of different components, 
especially the position of the GPIO pins and 
other connection ports so that they can be 
easily accessible,” he continues. “It was also 
very tricky to squeeze all the components into 
such a tight space. But I guess one thing that 
differentiates this project from the others is 
that all of the components can be purchased 
off-the-shelf, and it does not require any PCB 
design experience.” 

The end result is a stunning, expandable 
machine that boots, by default, into the 
command-line interface. The frame buffer is 
enabled in the /boot/config.txt file to display 
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A bit of BlackBerry magic 


da 


Zhou Xu dropped the USB port because 
01 Raspberry Pi and the LCD screen were pretty 
much drawing the power supply's capacity. But he 
used an l2C connection for the keyboard so added 
it again! 


Frustrated that the BBQ20KBD keyboard does 
02 not have ESC and CTRL keys, Zhou sought 
help. He said he was able to get the BBQ20KBD I2C 
driver (magpi.cc/bbq2okbd) working, which allowed 
the function keys to be mapped. 


320x240 resolution and, as well as being great 4 The back of the 
i Pur Blackberry Pi makes 
for entering code, the Blackberry Pi is able to use of a Raspberry Pi 
) ; j Camera Module 2 - the 
capture photos. It’s proving to be quite a useful a een 
Linux handheld. NoIR version 


But Zhou is not yet finished. “As I mentioned 
earlier, Pll be adding a Sense HAT and an SDR 
dongle. I also recently added a light guide to the 
USB charging port using translucent 3D-printing 
filament, so that the Adafruit PowerBoost status 
LED lights can be visible from outside the 
enclosure (green being fully charged, orange 
charging, and red showing low battery). 

“Unfortunately, the progress has been slow 
lately because there are a few other projects 03 Using translucent 3D printing filament has 
which have been keeping me busy, including allowed Zhou to add a great-looking power- 
using a Raspberry Pi to remote-control an status light to the USB za con When it is 

; : orange, as shown, here it is charging. It'll turn green 
electron microscope and optical filters, but : N 
i . when full, and red when it needs charging. 
everything seems to be working very well.” 7 
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Drill Press Camera 


A desire for absolute precision was this maker's driving force, 


Nicola King admires the microscopic details 


John 
McNelly 


A tinkerer who is 
fond of making and 
breaking new things 
with electronics, 
software, and 
mechanical 
engineering. John 
lives in Campbell, 
CA, and works as an 
electrical engineer. 


johnmcnelly.com 


John McNelly found that one of the most 

frustrating and time-consuming parts of 
fabricating two-sided boards was drilling the 
through-holes. Keen to speed up the process, he 
created the Drill Press Camera, a clever piece of 
kit that makes his life so much easier. 

“T got tired of squinting at a teeny-tiny drill bit 
attached to a benchtop drill press,” John explains, 
“so I built this project so that I can squint at a 
teeny-tiny screen attached to a benchtop drill 
press instead. The microscope camera has an 
HDMI output that I’ve been meaning to hook up 
to a larger display, but even with the small built- 
in screen, the magnified image has made drilling 
much faster and more accurate.” 


E xperienced at etching PCBs in his garage, 


Practicalities 

John’s project works by using an angled, mirrored 
periscope to point a microscope camera at the 
underside of a drilling platform. “The position 

of the Drill Press Camera is adjusted until the 


=| 


“S99 99999299SFSSS32- 
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A Housed in a protective case with the other electronics, 
Raspberry Pi Pico controls the LED strip lighting for the project 
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crosshairs on its screen are lined up with the 
centre of the drill bit,” he says. “Once a PCB is 
placed on top of the drilling platform, the user can 
see a magnified view of the traces and intended 
drilling location.” Since the position where the 
drill bit will make a hole is indicated by the 
crosshairs on the camera screen, “lining up holes 
with the centre of the drill bit is about as easy as 
point and shoot.” 

A Raspberry Pi Pico is used to control the LED 
strips that illuminate the underside of the PCB, 
and John has written a simple MicroPython script 
that “reads brightness and hue values from 
two potentiometers on the control board, and 
sends the corresponding NeoPixel commands 
to the high-density LED strips embedded in the 
periscope.” John wanted the ability to dim the 
LEDs and also added colour control: “With some 
experimentation, I found out that controlling the 
colour of the LEDs was a cool way to improve 
contrast on some material types.” 


Reviving concepts 

John estimates that he is now twice as fast at 
drilling holes than when he was aligning by eye, 
and “my holes are also much more accurate.” 
Unsurprisingly, the project has garnered a good 
deal of enthusiastic reaction, especially regarding 
the periscope configuration. “One [Hackaday] user 
pointed out that I had pretty much reinvented 
something from the 1970s called a ‘Target Drill’, 
which is pretty cool.” 

John is more than happy to have reintroduced a 
drilling concept to a new generation: “There’s a lot 
of really neat fabrication equipment from the good 
old days, when people made PCBs by hand, that 
has since faded away.” After taking this project to 
Open Sauce in San Francisco earlier this year, he 
found that “lots of maker types were curious about 
it, and then quite enthusiastic about the concept 
once they saw how it worked! Drilling precise 
holes in flat things is apparently not a problem 
that is unique to PCB fabrication.” 


The drill press platform includes 
Pico-controlled LED lighting, 
adjustable with two rotary 
potentiometers at the rear 


A periscope-style section 
features an angled mirror to 
enable the camera to see the 
underside of the platform 


> John spent around 
50 hours on 
the project.. 


The LCD camera view 
features crosshairs to 
aid precision alignment 


of the drill with the hole : . 
> „including 


20-30 hours on the 
CAD model 


> The total cost of 
the build came in at 
under $300 


> See John's GitHub 
for full details: 
magpi.cc/ 
drillpressgh 


> Have any 
questions? He's 
happy to help: 
johnmcnelly.com/ 
contact 


If you’d like to build your own, John is more 
than encouraging, claiming this design is easy to 
build if you have access to a 3D printer and some 
soldering supplies. “Most of the stuff is pretty easy 
to get, but I’ve only been able to find one supplier 
for 2-inch glass circles of the right thickness. 
Since the microscope camera’s field of view passes 
almost entirely through the hole drilled in the 
glass disc, I think that a 3D-printed disc with a 
hole in it could substitute for the custom glass part 
just fine.” Go forth and create, as John would love A Connected to Pico, a custom PCB features two potentiometers 
to see what you come up with. 7 to adjust the colour and brightness of the LEDs 
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TouchCam camera 


A love of making shines through in this Raspberry Pi 
4-based TouchCam project, finds Rosie Hattersley 


Mukesh 
Sankhla 


Siemens India 
software and loT 
developer Mukesh 
loves making and 
documenting 
electronic, 
mechanical, and 
software projects. 


magpi.cc/ 
touchcamins 


The TouchCam's 
screen provides 
instant video and 
time-lapse playback 


ukesh Sankhla’s enthusiasm for tech 
M jumps off the page. His responses to The 

MagPi’s questions about his TouchCam 
camera project are packed with words such as 
‘inspire’, ‘love’ and the absolute joy he’s found 
in sharing his roster of makes over the past three 
years. Having completed his studies only a year 
ago, the computer science graduate was quickly 
snapped up by Siemens India, where Mukesh 
works as a software engineer with an Internet of 
Things focus, and spends his spare time creating 
and sharing technology-based designs. The 
TouchCam has gone through several iterations, 
which Mukesh has shared as an Instructable: 
magpi.cc/touchcamins. Its design is loosely based 
on Adafruit’s 3D printer camera case for Raspberry 
Pi HQ Camera (magpi.cc/hqcam3d). Mukesh’s 
initial version, the PiCam, added remote access 
options and was pitched as a means of monitoring, 
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as well as offering on-demand photography and 
remote printing. He used Fusion 360 to come up 
with his own camera case design, and NextPCB for 
the bespoke printed circuit board. Both the Linux- 
based PiCam and the TouchCam have Raspberry Pi 
4, at their core and Remote.It and SSH, so the HQ 
camera can be triggered from anywhere. 


m My goal was to 
blend my love for creating 
things with my technical 
knowledge Ø 


Iterate and improve 

Designing the TouchCam gave Mukesh a chance 
to combine his skills as a maker and a computer 
science enthusiast. “My goal was to blend my love 
for creating things with my technical knowledge,” 
he enthuses of the versatile device “that can 

even work as a server for my test applications 

and database.” 

Perhaps it’s no surprise that, as a computer 
engineer and developer, Mukesh works in a 
process of continuously improving successive 
designs. Mukesh says many of the design updates 
and improvements he made when moving on from 
the PiCam and developing TouchCam were directly 
influenced by the feedback he got from the design 
of the PiCam. It is also an apposite demonstration 
of how far his Fusion 360 computer-aided design 


Mägpi 


N A DFRobot touchscreen on the 

rear allows for on-body camera 
controls, while Remote.lt software 
means it can also be used remotely 


| 


Raspberry Pi HQ camera and 8GB 
Raspberry Pi 4 power the TouchCam 
and provide time-lapse photos and 
HD video footage 


Mukesh is justifiably proud 
of his Fusion 360 CAD skills, 
resulting in this gorgeous 
3D-printed camera case 


The TouchCam 
took about a week 
to print and build 


It cost around $170, 
but has no 
running costs 


Mukesh has used it 
as the ‘eyes’ of 
his robot 


Astrength of being 


able to control 
it remotely 
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RPı Cam 2023.07.02_1 7:26:25 


A Asample photo 
taken using the 
TouchCam triggered 
remotely 


skills have developed and was used to showcase 
his design prowess for his BSc. 

With the TouchCam, Mukesh was keen to design 
a system that is compact and easy to carry and that 
would appeal to multitaskers who enjoy activities 
such as 3D printing, time-lapse photography, 
electronics, robotics, programming, and machine 
learning. He also thinks the TouchCam could be 
used for software development, low-cost personal 
servers, and similar uses. 


P Raspberry Pi HQ 
Camera offers high- 
quality photography 
using its 12.3 
megapixel Sony 
IMX477 sensor 


m | chose the Raspberry Pi 
because it's affordable, 
powerful, and has an 
internet full of resources Ø 


Fine new features 

The TouchCam builds on the PiCam by integrating 
a high-definition touchscreen display and has 

a touch sensor that is used for live view, to 

access the photo gallery, and to switch between 
still, time-lapse, and video capture modes. The 
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TouchCam tips 


You'll need a Raspberry Pi 3B+, 4, or 5, a 
Raspberry Pi HQ Camera, and a touchscreen 
display. Design or reuse an existing case or use 
Mukesh's STL files at: magpi.cc/touchcam360. 


x A TouchCam is an 
HQ Camera remote server also gained more evolution of the 


prominence. “I chose the Raspberry Pi because PiCam Mukesh 


designed and built 3 P 
Assemble the camera case, adding a heatsink 


for Raspberry Pi 4. Follow the instructions at: 
magpi.cc/touchcamins. 


it’s affordable, powerful, and has an internet full 
of resources. I am using the Raspberry Pi 4 8GB 
variant.” The components were sourced online, 
with standard items such as the HQ Camera paired 
with a DFRobot Raspberry Pi Touchscreen, cooling 
from a 5V fan, and open-source software libraries 
such as Imager, and Silvan Melchior’s Raspberry Pi 
Camera Web Interface (magpi.cc/rpicamwebint). 
Having already got the basics down pat with 
the PiCam, the case design and touchscreen 
integration were the real challenges for this build. 
Only three 3D-printed versions were needed, and 
even these were simply to fix minor fit issues to 
accommodate the screws. Overall, Mukesh was 
pleased with the way the TouchCam turned out: 
“Everything from the outer shell that feels good to 
hold, to the special mounts that hold the camera 
perfectly. Each piece came from my careful design 
work, making sure they look good and work 
just right.” 7 


Use Remote.lt to run the camera remotely. All 
the code you need to program the TouchCam is 
at: magpi.cc/touchcamgit. 
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ScreenDress 


We'd definitely say yes to this dress - a stunning creation by Anouk Wipprecht 
that is proving to be an eye-opener, as David Crookes discovers 


Anouk 
Wipprecht 


Anouk Wipprecht is 
a Dutch FashionTech 
designer and 
innovator who works 
and travels between 
San Francisco, Los 
Angeles, Miami, 

and Amsterdam. 


anoukwipprecht.nl 
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computing don’t always go hand-in-hand. 

But bring amazing talent such as Anouk 
Wipprecht on board and all eyes are definitely 
going to be on the wearer - as this striking 
ScreenDress shows to great effect. 

As well as fitting snugly around the body, 
the 3D-printed dress includes a set of circular 
LCD screens, each of which looks like an eye. 
Connected to an EEG sensor - a four-channel BCI 
headset developed by neurotechnology company 
g.tec - they change according to how the wearer 
feels by reading brainwaves and working out a 
person’s cognitive load. 

To that end, the screens can show signs of 
stress, fatigue, and frustration. The more a person 
subconsciously feels 
their mental load is 
increasing, the wider 
the iris and pupils 
dilate. By making 
changes in real- 
time, Anouk, a Dutch 
FashionTech designer, says the dress is able show 
a direct correlation between a person’s actions 
and their brain’s reaction. One thing’s for sure, 
it’s certainly eye-catching. 


[ t’s fair to say that clothing fashion and 


Dress to impress 
ScreenDress was created from scratch. As 
well as the headset - called the Unicorn 
Headband - the dress was designed in Onshape 
(magpi.cc/onshape), a free, cloud-based CAD app. 
Anouk said it helped her to understand the look 
and feel of the possible embedded LEDs and how 
light reflected back on the body and space around 
it. “I used various Onshape design capabilities 
including mixed modelling, generative design, 
render studio, and in-context design to reference 
hardware elements,” she adds. 

The dress was outputted to an HP Jet Fusion 
5420W 3D printer using a form of nylon. “This 
material is ideal for engineering-grade, white, 


m The 3D-printed dress 
includes a set of circular 
LCD screens Ø 


quality functional production parts,” Anouk 
continues, pointing to the components being light 
- an important factor when being worn. 

Behind each of the HyperPixel 2.1 round hi-res 
screens that display the eyes are Raspberry Pi Zero 
2 W computers. “There are six of them,” Anouk 
says. They take information from the sensor that 
has been analysed in real-time and determine 
how the animated eyes appear on the screen. 


Got the look 

To ensure the ScreenDress is in-tune with the 
wearer’s brain, anyone wearing the clothing, 
which has the eyes flaring out from a sculpted 
neck-piece, has to undergo a two-minute 
training session. Machine learning then begins 
to understand the 
wearer’s mental 
workload so that the 
eyes work as accurately 
as possible. 

“Our fortunes turned 
when Raspberry Pi 
Zero 2 W, equipped with a quad-core Cortex A53 
processor, was released,” Anouk says. “This 
upgrade significantly enhanced the processing 
capabilities [over Raspberry Pi Zero W], allowing 
us to manage data seamlessly and achieve the 
desired performance.” 

ScreenDress is certainly cool and it turned a lot 
of heads when it was first put on show at the ARS 
Electronica Festival in Linz, Austria in September 
before being presented in Budapest, Hungary and 
Eindhoven, Netherlands. It has also posed a lot 
of questions. 

“What does it mean when we can connect 
technological-expressive garments to our bodies, 
body signals, and even emotions? What dialogues 
can we trigger? This is what I am exploring with 
designs like these,” Anouk explains. It also means 
that Raspberry Pi computers can be seen as a 
fashion accessory, potentially inspiring many 
other makers. 7 
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The wearer needs to don 

an EEG sensor as part of a 
3D-printed headset called the 
Unicorn Headband, designed 
by Anouk and tech firm g.tec 


Each eye is a 2.1-inch 
HyperPixel 2.1 Round 
480x480 touchscreen 
capable of displaying 
18-bit colour images at 
60 frames per second 


The lightweight neck-piece 
is designed to hold the eyes. 

Raspberry Pi Zero W computers are 
hidden from view behind each eye 


A ~“ N 
Quick FACTS 


> The dress has been 
featured around 
the world 


> Each eye is 
powered by 
Raspberry Pi 


> It uses a type of 
nylon called PA12 W 


> The prints 
remain white and 
don't discolour 


> A prototype is 
displayed at the 
Museum voor Beeld 
& Geluid 
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Camera 


A little tinkering has given this classic camera a 
second shot. Nicola King focuses on the facts 


Max van 
Leeuwen 


Max studied at the 
Netherlands Film 
Academy. After working 
in visual effects for 

film, he now develops 
augmented reality and 
interactive installations. 


maxvanleeuwen.com 


> Raspberry Pi is 
equipped with a 
Waveshare Li-ion 
Battery HAT, enabling 
a 14500 battery to be 
recharged via USB-C 


some people, not prove particularly 

inspiring. However, Max van Leeuwen’s 
grandfather had given him the antiquated object, 
and Max was determined to give it a new impetus. 
“T really wanted to hide a Raspberry Pi in there 
and bring this vintage object back to life in some 
way,” he tells us. “I loved the idea of adding some 
mysticism to it. At first, I wasn’t sure what to 
make with it, though...” 

When Max came up with the idea of adding an 
e-paper display module to the mix, he knew he 
was on the right track. “I wanted to make a live 
picture frame right away... This idea felt right 
because, now, I could give the picture frame to 
my grandma and keep her posted (it lives in her 
bookcase now).” 


A broken Polaroid Land Camera may, for 
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A Raspberry Pi 3A+ 
with a Li-ion Battery 
HAT is secreted in 
the body of the old 
Polaroid camera 


A flash of inspiration 

Using a Raspberry Pi Camera Module 3, a couple 
of Raspberry Pi 3 Model A+ boards, and some 
Python code, along with the other required 

bits of hardware, Max has essentially created a 
camera within a camera here, as a digital camera 
is hidden within the body of the original shell. 
“When the camera’s button is pressed, it makes a 
hidden digital camera take a picture,” he explains. 
“This picture is sent to a server, for the display 
frame to show.” 

Interestingly, Max decided that he wanted the 
picture to then be deleted from the camera itself 
and, once the frame has downloaded this picture 
to display it, it is deleted from its storage as well. 
“T really like the idea of having only one copy of 
the picture baked into the e-ink display. It makes 
the picture feel important, and it fits with the 
essence of Polaroid photos,” declares Max. When 
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The original lens 


was replaced with 
a Raspberry Pi 

Camera Module to 
take digital images 


With the image 
uploaded to a server, 
the e-paper photo 
frame can download 
and display it 


Quick FACTS 


> The hardware cost 
a new picture is taken, the old one disappears Max around €200 
from the frame. 

The e-paper display module was a key 
inspiration to Max to make the photo frame: “I 
really like the look of a display that doesn’t emit 
any light, so it’s more like an e-book instead of a 
screen. It’s really fun to see the individual dots on 
it; it looks just like a real print.” When he found 
a type of e-paper that could do colours, there was 
no stopping him. “The slow drawing speed of the 
e-paper module (~1 minute) fits with the idea of 
mimicking developing film, which was a happy 


> The parts list 
is in the GitHub 
repo: magpi.cc/ 
instantcamgh 


> This was one of 
Max's very first 
Raspberry Pi 
projects 


> Although time- 


accident,” he enthuses. ae 
i he thinks it's 
Max was determined that the camera should . 
straightforward.. 


send pictures to a server, instead of directly to the j W 

other device, so that it works “even if both devices H 

are on opposite sides of the planet.” Deciding 4 J affinity for coding 
against using a SIM card in the camera and frame, 4 Max considered using a Pico in the camera, but eventually opted can pick this up and 
he instead opted for Wi-Fi, and the camera simply for a Raspberry Pi 3A* for its extra RAM improve it!" 


> “Anyone with an 
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4 Comprising another 
Raspberry Pi 3A+ and 
e-paper display, the 
digital photo frame 
downloads each 
image from the server 


connects to Wi-Fi networks by taking a picture of 
a QR code. 


Shooting the snags 

Max found that the physical build was the hardest 
element of the project, and many hours of work 
went into the venture. “At first, I only made little 
steps at a time for a couple hours a week but, once 
it started taking shape, I dedicated a few days to 
it to make some real progress,” he reveals. Most 
of his time went into the physical photo frame 
and the camera body. “Breaking the camera 

open on the inside without breaking it on the 
outside was a bit of a tedious task. And the photo 
frame needed a wooden shape on the back to fit 
the computer and wires, so that became a little 
arts-and-crafts-session.” 

Max’s father was on hand to help him with the 
woodwork for the frame, but “I was scared I’d 
break the camera when drilling a hole through the 
top for an LED light,” he shares. Also, making the 
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real camera’s button trigger a signal necessitated 
some good old-fashioned trial and error. “I ended 
up using a metal spring with aluminium foil on it, 
and the ends touch when the button is pressed to 
make a closed circuit.” 


m | really like the idea of 
having only one copy of 
the picture baked into the 
e-ink display Ø 


Finally, deciding on power options for the 
camera demanded some further head-scratching 
- “I ended up using a battery HAT that works for 
about an hour on this setup and can be recharged 
with USB-C.” The end-product was well worth 
the labour and troubleshooting required en route, 
however. As long as there is Wi-Fi available, “the 
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photos you take with the camera appear instantly 
on the display frame, no matter where in the world 
each of them is.” 


From camera to frame 


No negatives here 
Understandably, many people have enjoyed 
reading about Max’s camerawork.“There were 
a lot of positive reactions online! I really loved 
reading them. All the individual steps to making 
this project are nothing new, but bringing them 
together into this simple idea is what people 
seemed to appreciate the most.” 

Significantly, he has had messages from a 
number of people who are keen to replicate 
his endeavours using similar vintage cameras. 
Describing this as “super-cool”, Max is very keen 01 Pacae oya Rete pe Serie Camer 
that people make their own variations and, indeed, Dr Module i> connected aoa Raspberry PISAT 
; fi : inside the Polaroid camera body, powered by a 
improvements to the project. “One possible Li-ion Battery HAT. 
variation someone told me about was to make 


multiple photo frames and connect them to the w Max handcrafted a 2 
wooden back for the photo 

same camera, so you can update a whole group at Faria to ft In Raspberry Pi 

once! That could be fun.” M and the wiring 


= 


When the camera's button is pressed, a circuit 
02 is completed, sending a signal to Raspberry 
Pi's Python program to light the flash LED and take 
a picture. 


03 The image is then uploaded via Wi-Fi to a 
server. From there, it can be downloaded to the 
e-paper display frame, no matter where it is located. 
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Gutter Probe 


Trying to discover the cause of a blockage, Peter Anderton invented an ingenious 
solution that resulted in a twist ending. Rob Zwetsloot listens to the tale 


Peter 
Anderton 


A civil engineer with 
a background in 
computer science 
who eventually 
became a software 
developer before 
semi-retiring, and 
now does a lot of 
making and puzzle- 
solving for fun. 
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some more surprising than others. When 
Peter Anderton emailed us about a very 

unique use of Raspberry Pi to solve a conundrum, 
we decided we had to share it in the magazine. 

“My wife and I had noticed that, whenever 
it rained hard, we were getting a serious 
overspill from one of our house gutters onto 
our conservatory,” Peter says in his email. 
“Unhelpfully, the overspill appeared to originate 
from an inner-corner joint of the gutter, over 
15 feet up and directly over the conservatory, so 
virtually impossible to reach without scaffolding 
or a cherry-picker, either of which would be 
extremely expensive if it turned out there were 
no alternatives. We first thought the cause might 
just be a leaky joint, but one day we spotted 
a suspicious growth poking out above the 
gutter itself.” 

With a bit of deductive reasoning, Peter figured 
out that the plant was blocking the joint, so the 


E aspberry Pi is used for a lot of things - 


A The original mount used to take a peek at the gutter 


rainwater would just overflow. He didn’t want 
to hire expensive equipment to confirm this 
theory, though. 

“I then had the bright idea of mounting a 
Raspberry Pi Camera on the end of a long pole to 
get a view of the plant itself,” Peter mentions. 
“The sticking-point here was how to connect the 
camera to Raspberry Pi whilst still being at the 
far end of the pole. At first, I considered having 
Raspberry Pi and camera both mounted at the far 
end, but this would have required much longer 
power and display cables than I had available; the 
obvious alternative was just to have the camera at 
the far end of the pole but, at the time, I only had 
to hand the short ribbon cable that came with the 
camera, and had no idea whether longer cables 
were even available. However, after discovering 
that cables up to 2m in length existed - thank 
you, The Pi Hut! - I had at least solved the 
connectivity issue.” 


Printed solution 

Peter turned to Fusion 360 to design and then 
3D-print a mount that would allow the Camera 
Module to slot inside a bike lamp bracket, which 
was then mounted to a pole. After taking a peek, 
Peter found the true culprit - a plant growing in a 
big clump of soil. 

“I now had a much clearer idea of what exactly 
we were dealing with, but there was still the 
matter of how to get the offending plant out,” 
Peter continues. “It was unlikely any cherry- 
picker would be able to fit through either of our 
side gates to reach the rear of the house where 
this gutter was, so it would have to operate from 
the adjacent road, with all the safety and other 
implications that would entail. However, to go 
down the scaffolding route would be equally 


A The culprit causing the rainwater to spill over 


m The success of this venture 
hds opened my eyes to 
the potential for remote- 
viewing generally @ 


problematic, not least because it would have to 
bridge over the conservatory to get to the gutter in 
the corner, with no obvious way to support it.” 
For one small plant, this was a bit overkill. 
However, he did have a pole that could reach 
the plant, so he began Phase 2 of the operation: 
attaching a trowel. He already had a WOLF-Garten 
system that he’d 3D-printed parts for, so he made 
a further extension to fit the trowel on. 


Remote gardening 

After digging up a bit of the soil, the plant was 
removed and the gutter stoppage fixed. It worked 
so well, it’s inspired him to do more. 

“T would be the first to admit that I produce 
more things using my 3D printer than I do using a 
Raspberry Pi,” Peter says. “However, the success 
of this venture has opened my eyes (no pun 
intended!) to the potential for remote-viewing 
generally using Raspberry Pi / camera combination 
and, to this end, I have bought a second 2m 
camera cable and connector, as well as a new 
Raspberry Pi Camera Module 3.” 7 


Sah Ub bata 


E 
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4 


Atwo-metre-long camera 
cable was used to extend 
the camera down the pole 


3D-printed parts allow 
all the components to fit 
together nice and simply 


nt 


| Quick FACTS È 


> The project was 
printed in PLA after 
initial tests in ABS 


> The WOLF-Garten 
tool was originally 
used to scrape a 
corrugated roof... 


„and Peter had to 
print a different 
scraper so it would 
fit properly 


v 


v 


Apart from the 
extra-long camera 
cable, everything 
used was stuff 


\ 


N 
` 


From a previous project, this F -N Peter had 
trowel worked perfectly to er # 
scoop out the offending plant F “> The original 
"A A camera used was 
A 2 A > A r a Raspberry Pi 
eo. > p< wn GE E Camera Module V1 
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PicoSynth 


One maker has turned PicoTouch capacitive board into a wave synthesiser, 
Lucy Hattersley channels her inner Kraftwerk 


Tod 
Kurt 


Tod is a maker 


from Pasadena CA. 


He runs ThingM, 
is co-founder of 
CrashSpaceLA 
hackerspace. 


mastodon. 
social/@todbot 
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musical synths and his latest creation is 
PicoSynth, a MIDI synthesizer based on the 
PicoTouch board. 

PicoTouch is a thin capacitive touch platform, 
and Tod’s software turns Raspberry Pi Pico into a 
MIDI synthesizer that he can use to play sounds 
directly, or connect to another computer to control 
audio software (magpi.cc/picotouch). 

The PicoTouch CapSense MIDI keyboard is a 
slim plastic board with 22 touch pads and 19 RGB 
LEDs. “It’s one of the thinnest MIDI controllers 
at about 6 millimetres when Raspberry Pi Pico is 
installed,” says Tod. 

The ten pads on the bottom are note triggers 
for the C major scale, while the two pads on the 
right shift the octave up and down. The top row 
of pads controls wave and filter functions. Finally, 
three ‘patch select’ buttons on the right move 
between different waveforms. You can pick the 
board up from Tindie for $11, although it will need 
a Raspberry Pi Pico soldering inside. 

“It’s not too bad!” says Tod. “It’s a pretty 
easy first-time, surface-mount device 
soldering project.” Tod has created a video 
showing how to solder Pico to the board 
(magpi.cc/picotouchsolder). 


T od Kurt is a maker with a love of 


There is also a PicoTouch Slidercase that is “a 
simple 3D-printable protective enclosure for the 
PicoTouch USB MIDI / HID controller board.” 

“The result is still very thin and helps prevent 
false triggers or bad calibration if touching the 
back on power up,” explains Tod. You print it in 
two pieces, and no supports are required. Snap the 
top piece around the PicoTouch board, then slide 
the combo into the bottom piece. A third ‘picocap’ 
piece can be printed and glued to the top piece to 
protect the Pico. 

The PicoTouch Synth software is installed 
on Pico as a ready-made U2F file (magpi.cc/ 
picosynthgit). The source code is also available. 


MIDI sound 

Once up and running, PicoSynth is powered by 

a USB-C socket on the right, and to the left sit 
three 3.5mm audio jack connections that provide 
audio out, MIDI in, and MIDI out. The device can 
be connected directly via USB-C to a computer 
running audio software, such as Ableton. You can 
also use Reaper if you want something that works 
natively on Raspberry Pi 


A PicoTouch inside its 
3D-printed ‘Slider’ case is a 
thin and small (and cheap) 
portable MIDI controller 


BT enmeno Maya ae 


` PROJE 


The capacitive pads act as 
buttons with the bottom row 
used as a scale of notes, and 
the top row adjusting the 
waveform pattern 


Pico needs to be soldered 
ontothe PicoTouch board 
which makes it an easy 

and fun soldering project 


Tod needed a MIDI 
controller for his 
computer 


The sound is generated by 
Raspberry Pi Pico which also acts as 
a MIDI connection when connected 


to a MIDI device or computer It's hackable, 


cheap, and thin 


The source code 
is available 


; It's designed for 
(reaper.fm/). The USB-C connection to Raspberry MIDI but you could 


It > currently running Pi Pico provides power and a MIDI connection in code the pads for 
C | rcu it Pyth onan d td | ki ng one step. This enables you to use the PicoTouch to anything 


play instruments in audio software. 
M | D | to MY com D uter “It’s currently running CircuitPython and The board costs 
talking MIDI to my computer which is running just $11 
Ableton Live so it can do monophonic and 
polyphonic stuff; you can even play drums with it 
if you want to,” says Tod. 
“It’s a lot of fun!” 


PicoTouch can 
be used for other 
projects as well as 


The PicoTouch bare board is available on Tindie 
creating PicoSynth 


if you nt to recreate this project at home 
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Arrıbada 


technology for 
conservation 


Raspberry Pi is key to Arribada's wildlife monitoring projects 


By Rosie Hattersley 


accessible monitoring tools are used 

routinely in conservation these days, but 
back in 2017, when Alasdair Davies founded his 
non-profit organisation Arribada, they were 
groundbreaking. Keen to draw attention to threats 
to wildlife in different habitats and locations, he 
set about developing low-cost monitoring tools, 
reasoning that equipment costs should not be a 
barrier to helping critically endangered animals. He 
produced and designed multiple observation tools, 


T ime-lapse photography and remotely 
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from a camera trap that would wake and detect an 
animal walking by, to a device that would send back 
an alert if a particular animal appeared. 

Davies founded environmental organisation 
Arribada (the name, meaning ‘arrival’, refers to 
the migration and birth cycles of sea turtles), with 
the aim of using technology to make a positive 
environmental contribution. 


THE CHALLENGE 
Arribada needed a robust, low-cost kit that could 
be used in remote locations, often without human 
intervention. Its first project was a tag to monitor 
green sea turtles: this tool would show the impact 
that fishing and human activity were having, and 
open discussions about what protections might need 
to be introduced for the endangered species. 

To track the turtles, Arribada’s solution would 
need to be waterproof at the depths at which 
the creatures swim, as well as being able to 
operate reliably without the possibility of human 
intervention. It also needed to be both affordable 
and accessible to local research teams. 


THE SOLUTION 
A Raspberry Pi Zero and a Raspberry Pi Camera 
Module were enclosed in a lightweight, waterproof 
enclosure. This could be attached, harmlessly, to 
the shell of a sea turtle, to track its journey under 
the waves. The device captures photos, video, and 
location data. 

“Once the video has been recorded, the tag is 
released from the shell of the turtle and is then 
recovered from the water’s surface two weeks 


later. This lets us capture behaviour footage of both 
female and male turtles,” Davies explains. 

A challenge for turtle monitoring is that GPS 
location tags are only effective when the creature 
surfaces, which is often for less than two seconds. 
Waking up the monitoring devices to get a 
triangulation fix is not instantaneous, so Arribada 
developed its own Horizon Assisted-GPS tag as a 
key part of its Raspberry Pi Zero-based kit. 

The kit means that turtles’ behaviour, as well as 
their locations, can be discerned. The first turtle 
tags were developed when AI and machine learning 
were in their infancy, but, Davies says, we’re in 
a very different space now. “You can imagine 
the benefit of running AI models on Raspberry 
Pi devices for the sea turtle: we can wake up [the 
device], capture a scene, process that scene, we 
can even [get the device to] make some intelligent 
decisions to say, is this worth recording? Is it worth 
going back to sleep, or should I stay on?” 

In addition to making decisions about continuing 
to monitor a site, perhaps going into a sleep cycle 
and awakening again an hour later to see what’s 
changed, using Raspberry Pi offers machine learning 
advantages. “We can pull the models off, sit there 
and go through and train them a little bit more, 
tweak and review the video content. We can do 
it all at very little cost, because [Raspberry Pi] is 
so affordable.” 

It’s an approach that has begun to mark out 
Arribada as a sophisticated research partner, with 
conservation organisations showing “a real interest 
in what Edge ML is going to do. We still use it 
on the Raspberry Pi. We don’t just use it with 
sea turtles.” 

Some initiatives need bespoke solutions. This 
was the case in Cyprus where the Society for the 
Protection of Turtles (SPoT), one of the country’s 
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longest-established conservation charities, was keen 
to explore the use of LoRa radio communications to 
monitor fishing activity. 

The boat-based LoRaWAN gateway that 
Arribada set up can provide a detailed overview 
of local fishing activity, and report any potential 
encroachment on the five critical turtle breeding 
sites around the country’s coast. Cypriot mobile 


m The Penguin Watch camera units survived 
three Antarctic winters before the Arribada 
team made a maintenance visit Ø 


phone regulations, requiring SIM cards to be 
registered after four months, made using them 

for cellular communications troublesome, hence 
the LoRaWAN setup using a Raspberry Pi 4 with a 
Raspberry Pi Power-over-Ethernet HAT. This setup 
also meant there was no cost to the boat owners 
for having a tracking system on-board. An antenna 
on an eight-metre pole offered a clear view of any 
fishing vessels in a 15km radius, providing a robust 
and visible monitoring system. 


WHY RASPBERRY PI? 

Raspberry Pi has become a keystone to almost all 
of Arribada’s projects. Davies explains that it has 
always been one of the tools he uses “because 

it is so accessible and affordable for anyone to 

get involved. You are always partnering with a 
researcher or a local community member who works 
with an NGO and has a specific challenge. We get 
called in to solve it with technology. They’ll always 
say it has to be affordable, it has to be repairable 
and accessible.” 
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Davies has used Raspberry Pi with various HATs 
to create whichever tool was needed, but after 
Raspberry Pi Pico became available in 2021, he found 
the low-cost microcontroller board often provided 
a solution. 


THE RESULTS 

The footage gathered by Arribada’s Raspberry 
Pi-based turtle tags helped quantify the number 

of sea turtles, as well as revealing their nesting 
locations, bolstering arguments for specific 
beaches and coastal areas to be off limits at specific 
times of the year - a crucial protection for this 
endangered species. 

The low cost of Raspberry Pi hardware had a big 
impact too. Previously, many of the camera tools 
conservationists needed had such high price tags 
that research projects either became unviable or 
ended up severely limited in scope and impact. 
Often, the quantity of kits a project really needed 
could not be funded, or the high cost of repair 
and replacement meant that monitoring could be 
undertaken only once rather than repeated to track 
changes over time. 

Reducing the costs with off-the-shelf Raspberry 
Pi hardware - widely available and easily swapped 
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out for replacement or upgrading - was a game- 
changer. Instead of a camera costing £500, a sub- 
£50 Raspberry Pi Camera Module with a Raspberry 
Pi Zero or Zero W could be used. The ability to 
deploy many of these much more affordable kits 
meant it was possible to cover significantly larger 
territories and provide more accurate population 
estimates. In most cases, a 3D-printed waterproof 
case became the most expensive element of 

each kit. And, as new Raspberry Pi camera 
hardware became available, Arribada was able 

to make huge improvements to image and video 
capture capabilities. 

Arribada also won over the Penguin Watch 
project, a wide-ranging research project monitoring 
penguin populations in different parts of the world. 
Arribada’s Python-controlled Raspberry Pi camera 
setup came in at least three times cheaper than 
the commercial cameras the penguinologists had 
previously been using. The cost reduction meant the 
team had far fewer qualms about where monitoring 
kits were sited, and were more relaxed about leaving 
equipment in situ for remote monitoring, where 
some units would inevitably be subject to damage. 

In fact, the hardware proved impressively resilient 
to temperature: the Penguin Watch camera units 
survived three Antarctic winters before the Arribada 
team made a maintenance visit. They were able 
to retrieve three years’ worth of photos and found 
that the Raspberry Pi units had reliably woken to 
capture a photograph once a day every day, saving 
every single image. This photographic journal of 
the changing environment and its effect on penguin 
populations contributed directly to conversations 
about climate change and habitat loss. HI 
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Raspberry Pi (5) 


AUNCH 
PECIAL! 


It's here! Here are some ideas for the 
latest and greatest Raspberry Pi 


will be out. We’ve been waiting four years 

for this and we’re very excited to use it 
ourselves, and see what other people come up 
with. Which brings us to the age old question: 
what do you want to do with your Raspberry Pi? 

We have some answers for you, and with the 

new capabilities of Raspberry Pi 5 in mind. So get 
your brain into gear, and get ready to make. 


B y the time you read this, Raspberry Pi 5 
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Build a 


FILE SERVER 


Make a better NAS with the new features 
of Raspberry Pi 5 
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W An M2 SSD card will 
help bring down the 
power requirements 
for a file server 
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Alasdair Allan, Head of Documentation, who 
mentioned he was excited for the prospect 
of low-power NAS boxes that made use of the 
M.2 HAT coming to Raspberry Pi 5 in the future. 
Here are the basics of setting one up. 


| n The MagPi 134 (magpi.cc/134) we talked to 


Software setup 
You need to install Samba onto Raspberry 
Pi OS, usually done with: 


sudo apt install samba samba-common-bin 
We like to use NTFS for the shared drive so that 
other operating systems can use it easily, so we 


install that with: 


sudo apt install ntfs-3g 


Storage setup 

Usually we use an external hard drive, 
but using the SSD drive will be very similar - 
plug it in, make sure it’s formatted, and then 
mount it to Raspberry Pi OS. It will do this 
automagically when you plug it in once booted, 
but to automount it on boot (there is a difference) 
you’ll need to edit the fstab file with sudo nano 
/etc/fstab and add a line like: 


/dev/sdb1 /mnt/location ntfs nls-utf8, umask- 
0222, uid-1000,gid-1000,rw © @ 
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For full instructions, head to: 
magpi.cc/fileserver 


A Example code for your Samba config file 


Configuration 

The magic of the NAS box is in the Samba 
configuration file - it’s like writing a spell to 
open up the shared storage to the network. 
Here’s one example, and there’s another in the 
screenshot above, but tweak it to your own needs: 


[share] 

Comment = Network share 
Path = /mnt/location 
Browseable = yes 
Writeable = yes 

only guest = no 

create mask = 0777 
directory mask = 0777 
Public = yes 

Guest ok = yes 


=e Li 


a 


RAID NAS 


PJ Evans shows you a way to create a 
home file server with redundancies over at 
magpi.cc/raidnas. 


3D photos 


& VIDEO. 


Add an extra dimension to your 
photography and videography 


ith the ability to add two cameras to 
W one Raspberry Pi 5, it’s never been 

easier to create 3D video or take 3D 
photos with Raspberry Pi. It can take some 


tweaking to get it right, but here’s how you can 
get started. 


VR or movie 

There are two distinct ways for doing 
3D filming - the kind you see in movies with 
two slightly overlapping frames that 3D glasses 
selectively view to make the flat image on the 
screen have depth, and the VR version which 
either has two distorted images that a headset can 
render as a scene in front of you in high quality, 
or a slightly lower-quality 360° scene all around 
you. The latter uses two cameras with wide-angle 
lenses opposite each other, while the former use 
two cameras facing forwards, and can be a bit 
easier. Also, with the lack of 3D TVs these days, 
we’ll be looking at using a VR headset. 


A Aprevious version of 3D photography with Raspberry Pi 


Timing 

The trick to getting the perfect shot is 
timing the cameras. In a previous tutorial by 
regular PJ Evans, he linked up to Raspberry Pi 
Zero with cameras attached and had them shoot 
images at the same time. This was done with 
some smart Python code, and you can look at how 
he did it here: magpi.cc/make3dcam. 


Stitching 

The images or 
video, once created, 
need to be stitched 
together. For video, 
we suggest giving each 
one a look on video 
editing software to 
make sure they line 
up properly. PJ, in 
his tutorial, created 
a way for images to 
be put together for 
3D (find the code at 
magpi.cc/3dcameragit). 
However, you can also do it in video editors like 
Adobe Premiere. 


3D video now 


The POPCAM is a 360-degree 3D camera kit that 


uses Raspberry Pi CM4 - it’s not out quite yet, 
but we've been using a pre-release model and 
it's very good. If you'd like to skip the DIY, find out 
more at magpi.cc/popcamera. 
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A Create VR and 
3D video with 
two cameras and 
Raspberry Pi 5 


vV. 
® 


V Editing video 
together will be 
necessary 
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Media 


CENTRE 


Your media, but better 


Kodi have been mainstays for Raspberry Pi 

media centres for a very long time. With the 
new VideoCore VII GPU on Raspberry Pi 5, while 
hardware decoding of H.264 is no longer present, 
the power of the CPU is more than enough to play 
them and it allows for 4K H.264 media now too. 
What is exciting is the inclusion of H.265 and VC1 
hardware decoding, which is used in a lot of newer 
media for higher-quality files and audio. 

Setting up LibreELEC, our preferred method of 
using a media centre, is exceptionally easy: on 
Raspberry Pi Imager (magpi.cc/imager), when 
selecting an operating system, select ‘Media player 


| ibreELEC (in some form or another) and 


Retro 


GAMING 


Emulate more consoles than ever before 


ore power from Raspberry Pi means 
M more power to emulate the consoles of 

yore. We’ve already seen reports of the 
GameCube, and even the Wii, being successfully 
emulated on Raspberry Pi 5. However, you may not 
be able to quite get it 100% working on day one of 
Raspberry Pi 5. It likely won’t take long, though. 

We like to use RetroPie for emulation, which is 

available as an installation option in Raspberry Pi 
Imager - find it under ‘Emulation and game OS’. 
Set up is very simple, although you’ll have to source 
your own games. Check out magpi.cc/legalroms for 
how to do that. 
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OS’ and, from the menu, choose LibreELEC. Setup is 
simple, and you can check our ultimate media player 
guide for more info on that: magpi.cc/mediaplayer. 


The Audiophile Music Player and Streamer 


Operating System x 
< 2 
Go back to main menu 
Raed > 
A Kodi Entertainment Center distribution 
osmc @ > 
J A fast and feature filled open source media center 
| a > 


A There are other media-based OSes you can use with Raspberry 
Pi too, including audio servers 


Operating System x 
Back 
< Go back to main mens 
Retrapie 
> 


‘Turn your Raspberry P imp a retro gaming machine 


lua 0 > 


The DEY retro emulation console 


Resale @ > 
The retrogaming OS supporting 100+ gaming systema! 


A There are several options depending on your 
emulation needs 


Retro Gaming with 
Raspberry Pi 


a — 
Z f j 
This book has everything you © 
need for creating retro game s 
boxes or even making your own MRO GA yP! 
retro-style games. Grab it at appen? 
magpi.cc/retrogaming. R 
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Other 


PROJECTS 


Still not inspired? Here are a few more projects you might like... 


Portable desktop computer 


- we’ve used a Raspberry Pi 400 on many 

occasions for just that - but the extra grunt 
of Raspberry Pi 5, along with the new Raspberry 
Pi OS Bookworm, take it to a new level. 

To get it set up, you just need a Raspberry Pi 5, 

a mouse, a keyboard, and an available monitor or 
TV to plug into. Using the Raspberry Pi OS ‘Full’ 
version with recommended software pre-installed 
means you’ll have just about everything you need 
to get working, making art, or just relaxing with 
some YouTube. 


Q aspberry Pi 4 is a good desktop computer 


Other photography 


Raspberry Pi 5; normal photography 


Y ou don’t need to take 3D pictures with 
works just great. Over the years, we’ve 


covered many camera projects - from simple ith more 
photographs to time-lapses, surreal IR power in Br 
photos, motion-sensitive cameras, and even Raspberry 
astrophotography. Pi 5 comes a greater I 
You can even make use of two cameras similarly ability to crunch a = 
to the way smartphones do - two different lenses numbers. Whether ee 
on two different cameras allowing for macro practical or not, you 
shots or wide-angle shots can get a lot of Raspberry Pi into a small space, 
j — alongside regular photos, and people have created art installations, as well 
pIECA depending on the situation. as actual distributed computing setups. 
With better processing There are kits you can get for previous Raspberry 
speeds, along with the Pi models to help get them into a cluster, and 
f er) Í upcoming M.2 HAT, we’ve seen some people talking about upgrading 
you’ll be able to take alot these on social media - perhaps you could beat 
more photos as well. them to the punch. 1 
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ongratulations on becoming a Raspberry Pi explorer. 

We’re sure you’ll enjoy discovering a whole new 

world of computing and the chance to handcraft your 
own games, control your own robots and machines, and 
share your experiences with other Raspberry Pi fans. 

Getting started won’t take long: just corral the extra 
bits and bobs you need on our checklist. Useful additions 
include some headphones or speakers if you’re keen on using 
Raspberry Pi as a media centre, or a gamepad for use as a 
retro games console. 

To get set up, simply use your pre-written microSD card 
(or use Raspberry Pi Imager to set up a card) and connect all 
the cables. This guide will lead you through each step. You’ll 
find the Raspberry Pi OS, including coding programs and 
office software, all available to use. After that, the world of 
digital making with Raspberry Pi awaits you. 


Raspberry Pi Starter Guide 


All the bits and bobs you need 
to set up a Raspberry Pi computer 


A Raspberry Pi 

Whether you choose the new Raspberry 
Pi 5 or a Raspberry Pi 4, 400, 3B+, 3B, 
Zero or Zero 2 W (or an older model of 
Raspberry Pi), basic setup is the same. 
All Raspberry Pi computers run from a 
microSD card, use a USB power supply, 
and feature the same operating systems, 
programs, and games. 


PROJECT SHOWCASE | MägPi EEEE 


USB mouse 

A tethered mouse that physically attaches to 

your Raspberry Pi via a USB port is simplest and, 
unlike a Bluetooth version, is less likely to get 
lost just when you need it. Like the keyboard, 

we think it’s best to perform the setup with a 
wired mouse. Raspberry Pi sells an Official Mouse 
8GB microSD card (magpi.cc/mouse). 

You’ll need a microSD card with a capacity of 
8GB or greater. Your Raspberry Pi uses it to store 7 


games, programs, and boot the operating system. N 

Many Raspberry Pi computer kits come with a card Power supply 

pre-written with Raspberry Pi OS. If you want to Raspberry Pi 5, 4 and 400 need y 

reuse an old card, you'll need a card reader: either a USB Type-C power supply. Á 

USB or a microSD to full-sized SD (pictured). Raspberry Pi sells power supplies N \ {NS 
(magpi.cc/usbcpower), which k % 
provide a reliable source of power. R \ 
Raspberry Pi 1, 2, 3, and Zero models 

Windows/Linux PC or Mac computer need a micro USB power supply e 

You’ll need a computer to write Raspberry Pi OS (magpi.cc/universalpower). a 

to the microSD card. It doesn’t matter what — 


operating system this computer 
runs, because it’s just 
for installing the OS 

using the Raspberry Pi 
Imager app. 


Display and HDMI cable 
A standard PC monitor is ideal, as 
the screen will be large enough 
to read comfortably. It needs 
to have an HDMI connection, 
as that’s what’s fitted on your 
Raspberry Pi board. Raspberry 
Pi 5, 4 and 400 can power two 
HDMI displays, but require a 
micro-HDMI to HDMI cable. 
Raspberry Pi 3B+ and 3A+ 


USB keyboard both use regular HDMI cables; 
Like any computer, you need a means to enter web Raspberry Pi Zero W needs a mini- HDMI 
addresses, type commands, and otherwise control to HDMI cable (or adapter). 


Raspberry Pi. The Raspberry Pi 400 comes with 
its own keyboard. Raspberry Pi sells an official 
Keyboard and Hub (magpi.cc/keyboard) for 
other models. USB hub 
Raspberry Pi Zero and Model A boards 
have a single USB socket. To attach a a 
= = keyboard and mouse (and other items), N 
3 you should get a four-port USB hub N 
N ci (or use the official USB Keyboard 
eK gi N NEN and Hub which includes three ports). A 
RN ee Instead of standard-size USB ports, BS 
= Raspberry Pi Zero has a micro USB port 
(and usually comes with a micro USB to 
USB-A adapter). 
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Raspberry Pi 5 / 4 / 3B+ / 3 has 
plenty of connections, making it 
easy to set up 


Hook up the keyboard 

Connect a regular wired PC (or Mac) 
keyboard to one of the four larger USB-A sockets 
on a Raspberry Pi 5 / 4 / 3/3B+. It doesn’t matter 
which USB-A socket you connect it to. It is 
possible to connect a Bluetooth keyboard, but it’s 


much better to use a wired keyboard to start with. 


Connect a mouse 
Connect a USB wired mouse to one of the 
other larger USB-A sockets on Raspberry Pi. As 
with the keyboard, it is possible to use a Bluetooth 
wireless mouse, but setup is much easier with a 
wired connection. 


HDMI cable 

Next, connect Raspberry Pi to your display 
using an HDMI cable. This will connect to one of 
the micro-HDMI sockets on the side of a Raspberry 
Pi 5 / 4, or full-size HDMI socket on a Raspberry Pi 
3 / 3B+. Connect the other end of the HDMI cable to 
an HDMI monitor or television. 
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The Ethernet socket can be used to connect 
The USB-C socket is used to connect Raspberry Pi 400 directly to a network router (such 


power to Raspberry Pi 400. You can use a as a modem/router at home) and get internet 
compatible USB-C power adapter (found 


access. Alternatively, you can choose a wireless 
on recent mobile phones) or use a bespoke LAN network during the welcome process 
power adapter such as a Raspberry Pi 15.3W 

USB-C Power Supply 


Attach the micro-HDMI cable 

Next, connect a micro-HDMI cable to one of 
the micro-HDMI sockets on the rear of Raspberry 
Pi 400. The one next to the microSD card slot is 
the first one, but either connection should work. 
; ; Connect the other end of the HDMI cable to an 
Raspberry Pi 400 has its own HDMI monitor or television. 
keyboard - all you need to connect 
is the mouse and power 


The microSD 
If you purchased a Raspberry Pi 400 


Connect a mouse Personal Computer Kit, the microSD card will come 

Connect a wired USB mouse to the white with Raspberry Pi OS pre-installed. All you need 
USB connection on the rear of Raspberry Pi to do is connect the power and follow the welcome 
400. The two blue USB 3.0 connectors are faster instructions. If you do not have a Raspberry Pi OS 
and best reserved for external drives and other pre-installed microSD card, follow the instructions 
equipment that need the speed. later in ‘Set up the software’. 
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You'll need a couple of adapters to 
set up Raspberry Pi Zero / Zero 2 W 


01 Get it connected 

If you’re setting up a smaller Raspberry 
Pi Zero, you’ll need to use a micro USB to USB-A 
adapter cable to connect the keyboard to the 
smaller connection on the board. Raspberry Pi 
Zero models only have a single micro USB port for 
connecting devices, which means you'll need to 
either get a small USB hub or use an all-in-one 
mouse and keyboard. 


Raspberry Pi Starter Guide 


02 Mouse and keyboard 

You can either connect your mouse to a 
USB socket on your keyboard (if one is available), 
then connect the keyboard to the micro USB 
socket (via the micro USB to USB-A adapter). 
Or, you can attach a USB hub to the micro USB 
to USB-A adapter. 


03 More connections 

Now connect your full-sized HDMI cable 
to the mini-HDMI to HDMI adapter, and plug the 
adapter into the mini-HDMI port in the middle of 
your Raspberry Pi Zero. Connect the other end of 
the HDMI cable to an HDMI monitor or television. 
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First, insert your microSD With the microSD card fully Ta 
card into Raspberry Pi inserted, connect your power È i 


supply cable to Raspberry Pi. A 
red light will appear on the board 
to indicate the presence of power 


E Raspberry Pi 


Raspberry Pi OS 


nroducıng 


Raspberry Pi 


Get started guide covering 
every Raspberry Pi 


Everything you need to 
know about the brand new 
Raspberry Pi 5 


Inspiring projects for your 
next build idea 


Have some serious fun with 
electronics 


Learn robotics with our 
super-simple robotics 
tutorial 


Play retro games with the 
diminutive Raspberry Pi Pico 


* Raspberry Pi hardware not included 
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> 
Phil King 


A long-time 
contributor to The 
MagPi, Philis a 
freelance writer and 
editor with a focus 
on technology. 


@philkingeditor 


| You’ll Need 


> Raspberry Pi 


> 16GB microSD card 
(or greater) 


Using Ubuntu 
on Raspberry P1 


Enjoy a new Raspberry Pi desktop experience by installing Ubuntu Linux 


hile the official Raspberry Pi OS is 
W an excellent, easy-to-use operating 
system tailored for Raspberry Pi 
computers, there are numerous alternatives 
you can use instead - see our feature in issue 
111 (magpi.cc/111). The most popular among 
these is Ubuntu, based on Debian Linux (just like 
Raspberry Pi OS). 
One of the most commonly used Linux distros 
in general, Ubuntu offers a slick user interface, 
a wide range of up-to-date software, and the 
benefit of familiarity for anyone who’s already 
used it on another computer. And Ubuntu 23.10 
supports Raspberry Pi 5. 
We’ll walk you through how to install the 
Desktop version on Raspberry Pi and make use of 
some of its key features. 


Ubuntu versions 

The easiest way to install Ubuntu is 
to use the official Imager tool (magpi.cc/imager). 
Click on Choose OS, then ‘Other general-purpose 
OS’ > Ubuntu. You’ll see a list of different Ubuntu 
versions. The three main types are Desktop, 
Server, and Core. The last two of these lack a 
GUI by default, so we’ll stick to Desktop. For this 
there are two options: the latest version (at the 
top) and an earlier LTS (long-term support) one 
which may prove more stable. Choose 23.10 if 
available and you are using Raspberry Pi 5. 


Install Ubuntu 

Whichever Desktop version you choose 
in Raspberry Pi Imager, note that - unlike with 
Raspberry Pi OS - you won’t be able to access an 
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A The Files browser is similar to the one in Raspberry Pi OS, 
except you only have access to your user folders 


advanced options menu in Imager to preconfigure 
aspects such as the Wi-Fi connection and SSH. 

As usual, click on Choose Storage and select the 
microSD card that you have connected to your 
computer (typically via a USB card reader). You’ ll 
need at least a 16GB card for Ubuntu Desktop. 
Finally, click on Write to flash the OS to the 
microSD card - it’ll take a little while, including 
verification. When ready, eject the card and insert 
it into your Raspberry Pi. 


First boot 

Before powering it on, make sure Raspberry 
Pi is connected via HDMI to a monitor or TV. 
Powering up, the usual colour gradients image will 
appear briefly before the boot-up process begins. 
After a few text lines on a black screen, the Ubuntu 
logo appears, followed by Ubuntu’s purple desktop 
background and a System Configuration window. 

This is much like the setup wizard in Raspberry 

Pi OS: choose the language, keyboard layout (or 
detect it), connect to a wireless network (or skip 


The Dash sidebar shows 
favourite apps and tools; a red 
dot indicates an app is running 


Click the Show Apps icon 
to see a grid of allthe 
apps currently installed 


for now), and select your location. Finally, enter 
your details: name, computer name, username, 
and password. You can opt to log in automatically 
or require the password. 

A ‘Welcome to Ubuntu’ screen and progress bar 
appears while it configures everything, followed by 
an ‘Applying changes’ window. It then reboots. 


The easiest way to install 
Ubuntu is to use the official 
Raspberry Pi Imager tool 


Final configuration 

Following the reboot, you’ll see the Ubuntu 
user selection screen with the username you 
selected. Click on it; if you opted to require the 
password to log in, you’ll need to enter it. 

Finally, the full Ubuntu desktop appears. A 
window offers you the option to connect to your 
online accounts - Google, Nextcloud, and/or 
Microsoft - but you can skip this for now and do 
it later in the Settings. You’re also asked whether 
to send system info to Canonical, and turn location 
services on. It then gives you a preview of some of 
the apps you can use in Ubuntu. 


Mägpi 


Click the taskbar icons for 
Wi-Fi, Bluetooth, audio, and 
power info and settings 


Navigate the desktop 

Ubuntu’s default desktop environment (you 
can install others) is GNOME, which is fairly easy 
to navigate once you get used to it. Here are the 
key areas: 


Dash: The left sidebar has shortcut icons 
for apps and tools - by default, Firefox, 
Thunderbird Mail, Files, LibreOffice Writer, 
Ubuntu Software, Help, and Trash. 
Activities: This option (top left) brings up an 
overview of current open windows. 

Show Apps: Clicking this icon (bottom left) 
shows all the installed apps. 

Home: Double-clicking this icon (bottom 
right) takes you to your home folder in the 
Files browser. 

Taskbar: At the top right you’ll find Wi-Fi, 
audio, and power icons; click to see their 
settings. Or click the time to view a mini 


calendar, along with any upcoming events on it. 


Launch an app 

After clicking the Show Apps icon at the 
bottom left, you’ll see a grid of icons for installed 
apps and other tools. Clicking the right-hand 
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Top Tip 


Mount a 
USB drive 


When you insert 
a USB flash drive, 
it's automatically 
detected and 

its icon appears 
in the Dash - 
remember to 
right-click and 
Eject before 
physically 
removing it. 
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A The Activities 
overview offers an 
easy way to switch 
between windows 
and workspaces 


TopTip è 


Shut down 


To shut down the 
system safely, 
click the top-right 
taskbar icons, 
then the power 
icon and select 
Power Down. 
There are also 
options to Restart 
or Log Out. 


arrow takes you to a second screen for more apps. 
In addition, there’s a search option at the top; just 
start typing and relevant app icons will appear. 

To launch an app, the Shotwell image organiser 
for instance, just click on its icon. It will open in 
anew window on the desktop, and its icon will 
appear in the Dash sidebar. To keep it in the Dash 
as a favourite, right-click the icon and select Pin 
to Dash (to remove, right-click and Unpin). 


m By default, there are two 
desktop workspaces which 
you can switch between @ 


07 Activities overview 
Naturally, you can run several apps at 
same time. The easiest way to see them all, and 
switch between them, is to click Activities (top 
left) to open an overview of all the open windows. 
Just click on one to select it. You can also search 
for open apps. 

You’ll also notice that, by default, there are two 
desktop workspaces which you can switch between 
- very handy to avoid clutter when multitasking. 
In Activities, you can drag and drop an app 
window from one workspace to another; an extra 
empty workspace will then be created, so you can 
have as many as you like! 
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Keyboard shortcuts 

Here are just a few of the many handy 
keyboard shortcuts you can use in Ubuntu. Note 
that SUPER is typically the Windows key, or 
Raspberry Pi logo key on Raspberry Pi 400. 


- SUPER - Activities overview 

» SUPER+A - Show Apps 

- SUPER+* - full-screen window 

- SUPER+¥V - revert to standard window size 

- SUPER++ - move window to left side 

» SUPER+> - move window to right side 

+ SUPER+TAB - switch between apps 

+ ALT+ESC - switch between windows in 
current workspace 

< SUPER+ALT++/> - switch between workspaces 


Install more apps 

While there are several ways of installing 
new software in Ubuntu (which we’ll explore next 
time), the easiest is to use Software Centre - akin 
to an app store. Click on the Ubuntu Software icon 
briefcase) in the Dash sidebar to launch it. 

In the Explore tab, you’ll see a range of app 
categories including Education, Games, and 
Productivity; clicking one shows the relevant apps. 
The other tabs show installed apps and available 
updates.) Alternatively, click the search icon (top 


left) and start typing the name of the app you 
would like to install. 

Clicking an app icon brings up its details 
screen, including user reviews (at the bottom) and 
whether it’s by a known developer. Click on Install 
and enter your password to download and install 
it. Once done, its icon will appear on the Show 
Apps screen. To uninstall an app, open its details 
in Ubuntu Software, click the Installed button, and 
select Uninstall. 


Change settings 

There are several ways to reach the Settings 
screen: by searching for it in Activities or Show 
Apps, or by clicking the icons at the top right of 
the taskbar and then the gear icon. 

There are numerous settings categories, 
including Appearance, Desktop, Notifications, 
Multitasking, Apps (individual app settings), 
Power, Displays, and Printers. 

In the Appearance section, for instance, you 
can switch to dark mode and/or select a different 
backdrop for the desktop - from the selection or 
by importing your own appropriately sized image. 


System update 
From the Show Apps screen, launch 
Software Updater (not to be confused with 
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Software & Updates). It will then check for 
firmware and software updates. You then have the 
option of installing them now or later. If you get a 
message about Software Updater not responding, 
click Wait. Enter your password to authenticate 
and install updates. It may take a while (so go and 
make a cup of tea). Finally, click Restart Now (or 
Later) to finish installing the updates. 


Taking it further 

Next time, we’ll cover more advanced Ubuntu 

aspects such as using the command line, 

enabling SSH and VNC, installing media codecs, Y 
using the GPIO pins, installing software from 

other sources, and switching to a different 

desktop environment. 7 


Open windows can 
be resized or shifted 
to the left or right 
side of the desktop 
for a neat split- 
screen view 


Viewing an app's 
details in the 
Ubuntu Software 
Centre; just click 
Install to download 
and install it 


cree nee erences ande 
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An introduction 


to MQTT 


Communication between your devices. 
By Tim Richardson 


homeigee 


inport paho.mgt 


client = matt.C 


The code running in the 
terminal subscribes to 
the queue ‘MyHouse/ 
garage/temperature’ 


Tim 
Richardson 


client. publish( 


Tim has been 
involved with 
Raspberry Pi's 
community almost 
from the start. He is 
part of the Pi Wars 
organising team 
and their resident 
course designer/ 
builder, as well as 
writing the CamJam 
Edukit worksheets, 
former CamJam 
organiser and 
current maker. 


@Geeky_Tim 


>>> 


earn how to send messages between 

Raspberry Pi computers, Raspberry Pi Pico, 

and lots of other devices using a simple 
protocol called MQTT. 

MQTT (Message Queuing Telemetry Transport) 
was originally created back in 1999 to bea 
lightweight way of passing small messages 
between devices on unreliable or low-bandwidth 
networks. Its main use is for machine-to-machine 
communication, or for the Internet of Things. 
Being lightweight means that it can be used by 
small, resource-constrained microcontrollers, like 
Raspberry Pi Pico. That does not mean its use is 
limited, though. There are plenty of ways you can 
use it within a home network, across the internet 
or even on a small cluster of devices that need 
to talk to each other. Its use is only limited by 
your imagination. 
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client, connect (" 


This code publishes 

to the queue. The 
message will appear 
in the terminal window 


t.client as mqtt 
lient("Sender"} 


localhost") 


"MyHouse/garage/temperature", * 


MQTT works on a publish/subscribe basis. 
That means a device can either publish (or send) 
messages or can subscribe to (or listen for) 
messages. In between the devices is what is known 
as an MQTT ‘message broker’. This is software that 
runs on a server that receives published messages 
and sends them out to subscribers. The broker is 
also lightweight, so any Raspberry Pi computer can 
run the MQTT broker software. 

To explain that with a real-life example, 
imagine you have a BME280 sensor connected to 
a Raspberry Pi Pico measuring the temperature, 
pressure and humidity within your garage or 
garden cabin. You are going to want to see what 
is being measured without going out to the garage 
or cabin or having to log into it remotely to get 
readings. You can program Pico as an MQTT client 
which will publish the measurements within 


your network. You can then program a Raspberry 
Pi computer, connected to a display of some 
description, to subscribe to those MQTT messages, 
interpret the contents, and display them on screen. 
That Raspberry Pi can even be running the MQTT 
broker as well as whatever software you use to 
display the measurements. Figure 1 illustrates a 
possible MQTT network structure. 


On topic 

MOTT clients publish to and subscribe to topics, 
which are a hierarchy similar to the folder 
structure on your computer. Think of the top level 
as being the home folder on your Raspberry Pi, 
/home. Underneath /home are the user folders, 
like /home/pi. And under that are various folders 
belonging to the user, like the Documents or 
Downloads folders, /home/pi/Documents or 
/home/pi/Downloads. The only difference with 
MQTT is that there is no ‘/’ at the beginning of the 
top-level topic. 

Let’s call our top-level topic MyHouse. 
Subtopics are added using a ‘/’ at the end of the 
top-level topic followed by the subtopic name. 

For example, MyHouse/garage. You might want 

to go down one more topic level and have a topic 
for the temperature only; e.g. MyHouse/garage/ 
temperature. This helps you to organise your 
MQTT into, say, rooms of the house, types of device 
(e.g. switch, light), what is being measured (e.g. 


m If you need to send 
information around your 
network then MOTT should 
be included within your 
armoury of go-to tools D 


temperature, humidity), action to be taken (e.g. 
toggle, turn on, change channel), or anything else 
you can think of. When publishing a message, it 
must always be to a specific topic (like MyHouse/ 
cabin/humidity), but when subscribing you are 
able to use wildcards to say ‘I want to receive all 
messages from the garage’ by using MyHouse/ 
garage/#, or ‘I want to receive all temperatures 
within the home’ using MyHouse/+/temperature. 
Figure 2 shows an example MQTT Topic structure. 
There is nothing special about the messages 
being sent around your network. They are plain 
text enclosed within the MQTT protocol, so you 
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don’t need to understand any complex structures 
to be able to use MQTT. You just need to decide 
what text you want to send (publish) and be able to 
interpret it on the other end (subscribe). 


A Figure 1: An example 
MQTT network 


Using MQTT 

MOTT is a well-defined and supported protocol. As 
such, there are plenty of broker implementations, 
both commercial as well as open-source. MQTT 
clients can be written in many languages, such as 
C, Python, C# or Rust. Lots of tools and software 
also support MQTT, like Node-RED and OctoPrint 
(3D printer control software). 

In this article, you are going to use an open- 
source broker called Mosquitto running on a 
Raspberry Pi. You will use some command-line 
tools to test your broker and learn to write simple 
clients with Python using the paho-matt library. 


Installing Mosquitto 

Prepare your Raspberry Pi by writing the latest 
Desktop Raspberry Pi OS image to a new microSD 
card and boot up Raspberry Pi. Update the OS to 
the latest version using: 


sudo apt update && sudo apt upgrade -y 
Now install the Mosquitto MQTT server and all 
of its dependencies, plus some command-line 


client tools that can be used to test the server: 


sudo apt install mosquitto mosquitto-clients 
=y. 


After installation, the Mosquitto server will be 
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garage 


> Figure 2: An 
example topic 
structure 


started via systemd. To check that the server is 
running, use systemctl: 


sudo systemctl status mosquitto 


If it is not running for any reason, the service 
can be restarted using: 


sudo systemctl restart mosquitto 


We will be using the default settings in this 
article, but there are lots of options to secure and 
otherwise set up your broker which we will be 
covering here. 


Sending messages 
First, you need to set up a subscriber to listen for 
the messages. Without one, anything published to 
a topic will go nowhere. 

On your Raspberry Pi with Mosquitto installed, 
open a terminal window and enter the following: 


TopTip è 


Topic Names mosquitto_sub -h localhost -t "MyHouse/ 


garage/temperature" 


Topics can be 

called pretty . 
much anything 
you like, but it 
helps to decide 
ona structure 
for when you 
add more 
devices later. 


Here, mosquitto_sub is one of the Mosquitto 
client tools you installed along with the 
Mosquitto server, providing a way to test the 
receipt of MQTT messages. 

+ The -h option identifies the hostname or IP 
address of the MQTT broker. Since the client 
tool is running on the same Raspberry Pi as 
the MQTT server, you can use localhost. 
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» The -t option identifies the topic you want 
to subscribe to. In this case, it is MyHouse/ 
garage/temperature. 


The test client will sit there and wait for a 
message to be sent on the topic. Leave it running 
and open a second terminal window and type in 
the following command to send a message on the 
chosen topic: 


mosquitto_pub -h localhost -t "MyHouse/ 
garage/temperature" -m "20.0" 


<- Again, the -h and -t options identify the 
broker and topic respectively. 


+ The -m option is the plain text message itself. 


If everything has worked, you should see ‘20.0’ 
appear in the subscriber client terminal. 

Test again by publishing another message, this 
time with a different number. It should once again 
appear in the subscriber test client terminal. 

Keep the subscriber terminal window open, as 
we are going to use it in the next section. 


Publishing messages 

Before we can program in Python, we need to 
install a library to add MQTT functionality to our 
code. We are going to use paho-matt. Run the 
following command to install the library: 


sudo apt install python3-paho-mqtt 
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matt_publish.py THE FULL CODE: 


The program mqtt_publish.py is the minimal » Language: Python 3 
code you can write to send MQTT messages. Type 
it in and run it. You should see the number ‘13.2’ 001. # An Introduction to MQTT, by Tim Richardson 
appear in the subscriber terminal window you left 002. 
running earlier. 003. # Import the paho-mqtt client library. 
The first line of code imports the client section 084. import paho.mqtt.client as mqtt 
of the paho-mgtt library. 085. 
The second creates a client object. ‘Sender’ is the 086. # Create an MQTT Client - the client ID must be unique 
client identification, and must be unique for your 087. client = mqtt.Client("Sender") 
broker as it is used to identify that client amongst 008. 
all the others that may connect. 089. # Connect the client 
The third line connects the client to the broker. 018. client.connect("localhost") 
As we are running this code on the same Raspberry e11. 
Pi as the broker, we are using ‘localhost’. 012. # Publish a message to the MyHouse/garage/temperature topic 
The last line of code publishes a message with 013. client.publish("MyHouse/garage/temperature", "13.2") 


the topic MyHouse/garage/temperature. Any 
client that has subscribed to that topic will receive 
that message. 


Subscribing matt_subscribe.py THE FULL CODE: 


The mqtt_subscribe.py program starts out the 
same as mqtt_publish.py by creating a client > Language: Python 3 © magpi.cc/mattgit 


(with a unique identifier) and connecting it to 


the broker. 

However, there is now a ‘callback’ function 081. # An Introduction to MQTT, by Tim Richardson 
named message_received. The client.on_message 082. 
line tells the client object which function to call 083. # Import the paho-mqtt client library. 
when a message is received on any topics that the 084. import paho.mqtt.client as mqtt 
client subscribes to. 085. from time import sleep 

The client.subscribe line subscribes the client 086. 
to a topic. You can subscribe to as many topics 087. # A function to handle any messages received 
as you want to, handling the message within the 088. def message_received(client, userdata, message): 
client.subscribe callback function 089. print("Message received on topic:", message.topic) 

Finally, the subscription loop is started, telling 010. print("Message contents:", message.payload.decode("utf-8")) 
the client object to start listening for messages. e11. 
The program then goes into a forever loop (or until 012. # Create an MQTT Client - the client ID must be unique 
you stop it). 013. client = mgtt.Client("Recipient") 

Open a new terminal window and run the 014. 
program. In the original window (or IDE) run the 015. # Connect the client 
mqtt_publish.py program. You should now see 016. client.connect("localhost") 
the subscriber report that it has received a message 017. 
on the topic MyHouse/garage/temperature with 018. # Define the 'callback' function when a message is received. 
its value. 019. client.on_message = message_received 

020. 

Conclusion 021. # Subscribe to a topic 
In this tutorial we have only just scratched 022. client.subscribe("MyHouse/garage/temperature") 
the surface of MQTT, but hopefully you now 023. 
understand what it is and how simple it is to 024. # Start listening for a message on the subscribed topics 
use. Areas not covered include securing MQTT, 025. client.loop_start() 
formatting messages, ensuring that messages are 026. 
received, using MQTT in Node-RED, and more. 027. print("Waiting for a message to be sent") 

If you need to send information around your 028. 
network, then MQTT should be included within 029. # Wait forever 
your armoury of go-to tools. 7 038. while True: 

031. sleep(1) 


An introduction to MQTT | magpi.cc | 57 


WE Magri | TUTORIAL 


Stewart 
Watkiss 


Also known as 
Penguin Tutor. 
Maker and YouTuber 
that loves all things 
Raspberry Piand 
Pico. Author of 
Learn Electronics 
with Raspberry Pi. 


penguintutor.com 


twitter.com/ 
stewartwatkiss 


Figure 1: Robot 
chassis design 
created in FreeCAD. 
Includes four motor 
brackets which are 
printed separately 


Raspberry Pı 
mecanum robot 


Create a robot which can go forwards, backwards, sideways, 
diagonally, and turn on the spot, The mecanum wheels allow 
the robot to navigate the tightest of spaces 


designing and making a wheeled robot This 

tutorial will explain how you can design and 
make your own robot. Start by designing your 
own chassis and mount mecanum wheels with 
full direction control. The robot will then need 
four separate motors individually controlled with 
a H-bridge driver for each wheel. Take control 
by learning how to use AntiMicroX to control the 
robot with a gamepad. 


T ake your Raspberry Pi on the move by 


Mecanum wheels 

Mecanum wheels are a type of 
omnidirectional wheel which can be used to move 
a robot vehicle in multiple directions. They are 
particularly good at getting into tight spaces as 
the wheels can propel the robot forwards and 
backwards as normal, but can then also move 
diagonally or sideways without any forward or 
backwards movement. 
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This is achieved by having rollers angled around 
the wheel. The rollers of diagonally opposite 
wheels need to be in the same direction. Turning 
the wheels in a certain combination will determine 
the direction. This is easiest to understand 
through watching the video on YouTube: 
magpi.cc/mecanumrobotyt. 


Creating a chassis 

For any kind of vehicle, you will need a 
chassis to mount the motors and electronics. You 
can use any method you choose. The base should 
be thin enough to accommodate the size of the 
wheels, but otherwise most materials can be used. 
You could use plywood, acrylic sheet, or even 
thick cardboard. 

If you have access to a 3D printer then you can 
design your own 3D-printed chassis, or use the 
one available at magpi.cc/robotmecanum. This is 
shown in Figure 1. 

You will need some way of fixing the motors. 
Brackets are included in the 3D printer files, or you 
can purchase suitable brackets which are included 
in the component list. 


Raspberry Pi Zero W 

Whilst any model of Raspberry Pi can be 
used, a Raspberry Pi Zero W or a Raspberry Pi Zero 
2 W are well-suited for a robot vehicle. They are 
small, making them easier to fit on a mobile robot, 
and they also have lower power requirements 
than some of the other models. The wireless 
capability is useful when programming the robot 


The special mecanum 
wheels allow the robot 
to move in any direction 


and for getting the controller working. A micro- 
USB to USB adapter is needed for connecting the 
controller. A shim adapter is also recommended. 


Powering the robot 
The motors are designed for 6V, whereas a 
Raspberry Pi needs a 5V power supply. In practice, 


A Figure 2: The motor driver is an SMD IC soldered onto a 
breakout board, allowing it to be used with a breadboard 


All four motors need 
to be controlled 
individually with two 
motor driver ICs 


you can normally use a single power supply for 
both your Raspberry Pi and the motors. 

The different options are a 6V power supply 
(4 x AA batteries) or a USB power bank. The 
breadboard layout shows both options. Raspberry 
Pi is powered through GPIO 2 using a diode which 
protects against reverse voltage and drops the 
voltage slightly. If using the USB power bank and 
the voltage is too low, then the diode bypassed 
if required. In either case, power must NOT be 
connected to your Raspberry Pi power input socket 
when powered through the GPIO. 


H-bridge motor controller 

To allow the motors to go both forwards 
and backwards, they each need an H-bridge. A 
good choice is the TB6612FNG driver. This driver 
can handle up to 1.2A of current, and has two 
H-bridge circuits on a single SMD integrated 
circuit. To be able to use these with a breadboard, 
they are available on a SparkFun motor driver 
board. This is shown in Figure 2. 

Along with the inputs for forwards and 
backwards, each H-bridge needs a PWM signal to 
set the speed of the motor. A single PWM output 
can be used from your Raspberry Pi, which will 
ensure that all the motors run at the same speed. 
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2 x TB6612FNG 
motor drivers 
magpi.cc/ 
TB6612FNG 


Mecanum wheels 
magpi.cc/ 
mecanumwheels 


4 x geared motors 
magpi.cc/ 
gearmotor 


Motor brackets 
magpi.cc/ 
motorbracket 


USB power bank 
magpi.cc/nanowave 


Micro USB shim 
magpi.cc/ 
microusbshim 


Wireless gamepad 
magpi.cc/ 
wirelessgamepad 


Micro USB breakout 
board 

magpi.cc/ 
usbbreakout 
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Figure 3: Breadboard 
diagram showing 

the wiring between 
the different 
components. There is 
both AA battery and 
micro-USB power 
connected, but only 
one should be used 
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> Figure 4: Schematic 


diagram which makes it 
easier to see which pins 
are connected. Labels 
are used to avoid the 
confusion where wires 
cross each other 
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Wiring up the circuit 

The wiring diagram is shown in Figure 3. 
This is just a case of wiring up the motor driver 
inputs with appropriate pins from your Raspberry 
Pi. Note that the breadboard has two different 
power rails. The top rail is connected to the 6V or 
5V supply for the motors, whereas the bottom rail 
is connected to the 3.3V pin on your Raspberry Pi 
to run the motor driver at 3.3V (so that it is at the 
same voltage as the GPIO pins). 


+3.3V +6V 


SDA/GPIO2= 
SCL/GPIO3¢ 


BT1 
Battery 


GND 
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A schematic diagram is shown in Figure 4. 
Note that the labels beginning with D indicate 
connections to the motor driver input, and M is 
used for the motor connections. 


07 Setting up the Raspberry Pi 
When setting up your Raspberry Pi, you 

may find it easier to enable VNC, which you can do 
through the Raspberry Pi Configuration tool. This 
will allow you to connect from another computer 
using a VNC client. Using VNC, you won’t need to 
connect a keyboard or mouse, allowing the only 
USB port to be used for the USB dongle for the 
gamepad controller. 

If using a game controller, then the AntiMicroX 
software is needed, which can be installed using: 


sudo apt install antimicro 


This will be configured later in the tutorial. 


Programming motor control 
The motors are controlled using GPIO 
Zero. There is an instance of Motor for each of 


+3.3V +6V 
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< Figure 5: A wireless 
USB gamepad. This 
is detected by Linux 
as an Xbox 360 
controller 


the motor drivers with a pin for forwards and An onen (came vn Were en 
reverse. There is then one more pin for the 

PWMOutputDevice which is used to control the speed 
of all the motors. 

The dictionary direction holds the direction of 
all four motors based on the selected direction. 
These are 1 for the motor to go forward, -1 for 
the motor to go in reverse, and @ to stop. It does 
not provide speed control, which is included in 
the code available from the GitHub repository at 
magpi.cc/mecanumrobotgit. - = Sn 


Adding keyboard support A wireless USB gamepad will be used, which 
One thing about Python is that it doesn’t needs to be mapped to the appropriate keys. An 
directly provide a way to read input characters example gamepad is shown in Figure 5. 


except when the ENTER key is pressed. There are 
various different ways around this, the one used 
here is a getch() function which provides similar 


A Figure 6: AntiMicroX 


functionality to the C/C++ getch() function. This Using gamepad with AntiMicroX converts game 
will pause the while loop until a key is pressed, AntiMicroX is an application which converts = ie ae 
and then return the key into the ch variable. gamepad instructions into keyboard or similar a 
The direction dictionary provides instructions. Start AntiMicroX from the accessories application, pressing 
mapping between the numerical keys and the menu. This will add a game controller icon to the mE a 
selected direction. top right of the screen. Clicking on that will allow appropriate button 
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you to map each of the buttons to the relevant 
keys, and this is illustrated in Figure 6. 

You can map each button on the gamepad, or 
import the suggested layout which is included in 
the GitHub repository. 


Troubleshooting 

The gamepad must be recognised by 
Linux to work with AntiMicroX. Some controllers 
appear to work consistently, whereas others need 
reconnecting once or twice before they will work 
with AntiMicroX. 

If the gamepad doesn’t work after a reboot, 

then you may need to try disconnecting and 


reconnecting the USB dongle after AntiMicroX is 
running. Then, choosing Update Joysticks from 
the menu. 


Future upgrades 
The robot can be controlled using a game 
controller, or using a keyboard. 

With some extra electronics and code, the 
robot can do more. There are holes included in 
the front of the chassis which can be used to add 
an ultrasonic distance sensor to detect and avoid 
nearby objects. Or, you could add a line sensor 
to allow your robot to follow a line drawn along 
the floor. M 


mecanum1.py 


DOWNLOAD 
THE FULL CODE: 


> Language: Python 3 


© magpi.cc/mecanumpy 


001. 
002. 
083. 
0884. 
085. 
086. 
007. 
088. 
089. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 


021. 
022. 
023. 


024. 
025. 
026. 
027. 
028. 


import sys, tty, termios 028. 

from gpiozero import PWMOutputDevice, Motor 029. 

030. 

motors = [ 031. 

Motor(2, 3, pwm=False), #Front left 032. 

Motor(22, 23, pwm=False), # Front right 033. 

Motor(14, 15, pwm=False), # Rear left 034. 

Motor(24, 25, pwm=False) # Rear right 035. 

] 036. 

pwm_out = PWMOutputDevice (18) 037. 

038. 

# get a character from the command line 039. 

def getch() : 848. 

fd = sys.stdin.fileno() 041. 
old_settings = termios.tcgetattr(fd) 

try: 042. 

tty.setraw(sys.stdin.fileno()) 043. 

ch = sys.stdin.read(1) 844. 

finally: 0845. 

termios.tcsetattr( 846. 

fd, termios.TCSADRAIN, old_settings) 047. 

return ch 

048. 

# list to convert key into motor on/off values to 049. 

correspond with direction 050. 

direction = { 051. 

# number keys 052. 

E E e A, 44, 21), # Turn left 053. 

'2' : (-1, -1, -1, -1), # Backwards 054. 

e (L as L, t) # Turn right 055. 


'4' + (-1, 1, 1, -1), # Left 
'5' : (0, ©, ©, 0), # Stop 
'6' : (1, -1, -1, 1), # Right 
:7" 2 (8, B;. 25-8), # Diagonal left 
8" (1,23, Bs DY, # Forwards 
NOs (1, 1855 1) # Diagonal right 
} 
current_direction = "stop" 
# speed is as a percentage (ie. 100 = top speed) 
speed = 50 


pwm_out.value = speed/100 


print ("Robot control - use number keys to 
control direction") 
while True: 
# Get next key pressed 
ch = getch() 
if (ch == 'q') : 
break 
elif (ch in direction.keys()) : 
direction 
for i in range (0, 4): 
if direction[ch][i] == -1: 
motors[i].backward() 
elif direction[ch][i] == 1: 
motors[i].forward() 
else: 
motors[i].stop() 
print ("Direction "+ch) 


# Quit 


# Change 
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Build a Bluetooth 


remote for a flashlight 


Make a remote Bluetooth remote control for the 
Pico-powered flashlight using MicroPython 


ecently, the author created a 
remote-controlled light based on 
an old camera flash he found for 
\ | sale on a market stall. The light 
4 — contains a Raspberry Pi Pico W 


programmed in CircuitPython that 


Rob Miles acts as a web server on a local network. The colour 
of the light is controlled via the web page hosted 
W @robmiles by the light. The Pico W also supports Bluetooth, 
and so in this project, a new version of the light 
Rob Miles has been is created which is controlled by a second Pico 
NEN W-powered device sending Bluetooth commands. 
and software since De f . 
almost before there was Continuing the upcycling theme of the previous 
hardware and software. article, this one uses an upcycled milkshake box as 
You can find out more á fi 
about his so-called tite at a case for the controller (Figure 1). You can find all 
robmiles.com. the software for the light and the controller on the 
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GitHub site for this project at this link: 
hsmag.cc/Bluetooth_Flashlight. 


NO NEED TO PAIR 

The Wi-Fi-controlled flashlight is configured with 
network credentials, and the user must visit a 
specific web address to connect to the flashlight 
controller page. The Bluetooth light and remote 
control use a Bluetooth addressing scheme in 
which there is no need to explicitly pair two devices 
that wish to communicate. There is no need to 
configure either the light or the control. However, 
if you wanted to use multiple lights with a single 
controller in the same room, things get a little 
trickier. You will need to use a different Bluetooth 
addressing scheme if you want to enable multiple 


connections. However, if you just want to send data 
from one device to another over short distances, 
the method described here works very well, and it 
is easy to change the type and amount of 

data sent. 


CREATING A REMOTE CONTROL 

Figure 2 shows the circuit diagram for the device. 
The three potentiometers are connected to the 
analogue-to-digital converter (ADC) inputs on the 
Pico. The input from the ADC is scaled to produce 
intensity values in the range 0-255. These values are 
sent via Bluetooth to the light. 


SENDING VALUES WITH CLASS 

The Pico W in the remote control runs a 
MicroPython program called ble_sender.py, which 
repeatedly reads the ADC devices connected to the 
red, green, and blue potentiometers and sends a 
block of data containing the colour intensity values. 
If the user adjusts one of the colour settings the 
updated value is sent out over Bluetooth to the 
light. The ble_sender program uses a class called 
BLE_sender. This is supplied with an instance of 

the ColourControls class which interacts with 

the potentiometers: 


def run(): 
print("Light sender starting") 
controls = ColourControls() 
sender = BLE_sender(controls) 
while True: 
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Far Left $ 
Figure 1. The 
light output has 
been reduced for 
the purpose of 
photography. 


Figure 2% 

The remote control 
works well with 

only three alkaline 
batteries, as the power 
requirements of the 
device are not high 


sender .update() 
time.sleep_ms(20) 


The statements above create a BLE_sender instance 

and feed it a ColourControls instance that reads the 

control inputs. It then repeatedly calls the update -= 
method in the sender, which reads colour values 

from the control. The ColourControls class reads the 

control inputs. The code for the class is shown below. 


class ColourControls: — 


f __ini 1f): 
Si. Vs YOU'LL NEED 
self.red_ADC = machine.ADC(0) 
self.green_ADC = machine.ADC(1) © Asuitable box 
(you can put 
self .blue_ADC = machine. ADC(2) the controll into. 
self .old_red=-1 anything you fancy) 
self .old_green=-1 © ARaspberry Pi 
self .old_blue=-1 Pico W (remember 
self .update() to get the 'W' 
version as this has 
Wi-Fi and Bluetooth 
def update(self): capability) 
self.red = round(self.red_ADC.read_ © 3» linear 
u16()/256) 10K rotary 
self.green = round(self.green_ADC.read_ potentiometers 
u16()/256) Other resistance 
values will work as 
self .blue = round(self.blue_ADC. read_ well. Make sure you 
u16()/256) get potentiometers, 
if self .red==self.old_red and self. noe iaay encoders. 
The potentiometers 
green==self .old_green\ will have only 
and self .blue==self .old_blue: three connections, 
whereas a rotary 
return False Sneoder will 
self .old_red=self .red have four 
self .old_green=self.green & Asingle pole 
self .old_blue=self .blue > single throw 
return True power switch 
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QUICK TIP 


Using the analogue 
power and ground 

connections on the 
Pico will make the 

analogue readings 
more stable. 


Below ® 

The control is set 

to around halfway. 
You can tell this 
because the little 
plastic finger over the 
wiper is connected 
to the centre of 

the circular track 
connecting the outer 
two contacts 


def pack(self): 
return struct.pack("<BBB", self.red,self. 
green, self.blue) 


The __init__ method is called when an instance 

of ColourControls is created. It sets up the ADC 
interfaces on the Pico and sets initial values used 
in the class. The update method is called to request 
an update of the red, green, and blue values held 
inside ColourControls 
class. The class stores u" 
previous values of red, 

green, and blue readings 

and update returns True 

if it detects the inputs 

have changed. The pack 

method returns the byte 

values to be sent to 

the light. It packs the red, green, and blue intensity 
values into three bytes. The BLE_sender class calls 
update and then calls pack if update returns True. 


TWO CLASSES ARE BETTER THAN ONE 
You may be wondering why two classes are used, 
when it would be perfectly possible for a single 
class to do everything. This is to provide flexibility. 
If you want to send values from a different device 
(for example you might want to send values 

from a distance sensor) you can create your own 
version of the ColourControls class (perhaps called 


POTENTIOMETERS 


AND ROTARY ENCODERS 


There are two types of twiddly knobs you can 
use with microcontrollers: potentiometers 
and rotary encoders. The former, which 
we've used here, create a changing 
voltage as they're turned. This voltage 
can be read by an analogue input. 
They're easy to use and hold a 
physical memory of their position (i.e. 
if you power off the project, they will 
read the same value when you power 
it back on). However, they can only be 
turned a fixed amount. Rotary encoders 
emit a series of pulses as they're turned, 
often with a soft click as they do. You can 
keep on turning them forever in either 
direction and they'll keep on pulsing. 
They're great for user interfaces (scroll 
wheels are one type of rotary encoder). 
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You don't need to know how 
the BLE_sender class works 
to send different kinds of = 
information using it 


DistanceControls) to read and pack the data from 
the distance sensor and use this class with the BLE_ 
sender class instead. You don’t need to know how 
the BLE_sender class works to send different kinds of 
information using it. As long as the class you create 
contains update and pack methods (and the update 
method returns True if the inputs have changed) it will 
just work. The BLE_sender class itself is based on the 
temperature sensor example in the Pico examples 
you can find here: hsmag.cc/MicroPython_ 
Examples. 


RECEIVING LOUD 
AND CLEAR 
Figure 3 shows the 
Pico from the flashlight 
being reprogrammed. 
m The Pico was loaded 
with MicroPython, as 
the original Wi-Fi-controlled light uses CircuitPython. 
Below, you can see the MicroPython code that 
runs when the light starts running. The Pico W in 
the controller acts as a server, serving out red, 
green, and blue intensity values which can be 
used to set the intensity of a light. The program 
ble_reciever.py runs in the light to receive these 
values. It uses a class called BLE_receiver to receive 
data from the controller and use the data to set the 
colour of the light. 


def run(): 
print("Light Receiver Starting") 
pixieLight = PixieLight(0.2) 
receiver = BLE_receiver(pixieLight) 
while(True): 
receiver .update() 
time. sleep_ms(50) 


The run function above implements the receiver 
behaviour. It creates a BLE_receiver instance called 
receiver. The receiver is given the device to control, 
in this case, an instance of the PixieLight class. 
Once the receiver has been created the run function 
repeatedly calls the update function of receiver. The 
update function creates a connection to a transmitter 
and then fetches blocks of data from Bluetooth 
which are then passed onto the pixieLight. 


from machine import Pin,UART 
from Pixie import Pixie 
import time 

import struct 


class PixieLight: 


def __init__(self, brightness, txPinNo=4, 

rxPinNo=5): 

uart = 
UART(1, tx=Pin(txPinNo), rx=Pin(rxPinNo), 
baudrate=115200) 

self .pixies = Pixie(uart, 1, 
brightness=brightness) 

self .old_red=-1 

self .old_green=-1 

self .old_blue=-1 

self .pixies[@] = (0, 255, ®) 


def render(self): 
self.pixies.fill((self.red,self.green, self. 
blue)) 


def set_colours(self,red,green,blue): 
if red==self.old_red and green==self.old_ 
green\ 
and blue==self.old_blue: 
return False 
self.red = red 
self.green = green 
self.blue = blue 
self.old_red=self.red 
self.old_green=self.green 
self.old_blue=self. blue 
self.render() 
return True 


def unpack(self, data): 
value = struct.unpack("<BBB", data) 
if self.set_ 
colours(value[@], value[1], value[2]): 
self .dump() 


def dump(self): 
print("Red:%3d Green:%3d Blue:%3d"%(self. 
red,self.green, self.blue)) 


The PixieLight class is shown above. The receiver 
will get blocks of data from Bluetooth and pass 

them to pixieLight by calling the unpack method. 
The unpack method is supplied with a block of data 
which must be unpacked and then used to set anew 
light colour. It sets the colours of the light and, if the 
colours have changed, it prints the new values to 
the terminal. 


TAKING OUT A CONTRACT 
The BLE_reciever and BLE_sender classes are not 


DI 
H 


| 


aware of the content of the data they are transferring. 
They just move blocks of binary data from one place 
o another over Bluetooth. The form and meaning 
of the data is determined by a ‘contract’ between 
he ColourControls and the PixieLight classes. The 
pack method in ColourControls assembles a block of 
hree bytes which contains the red, green, and blue 
intensity values selected by the user. The unpack 
method in PixieLight then takes these three values 
rom an incoming block and uses them to control the 
colour intensities in the lights it is driving. 

Both the classes need to agree on the encoding 
8-bit values) and the order (red, green, blue) of the 
values. Any misunderstandings will result in wrong, 
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Figure 3 

If the light output 
is not set very 
bright, the light 
software can be 
tested using just 
a USB connection 
for the power 
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class of your own which contains an unpack method 
that acts on the data that is received from the BLE_ 
receiver, but you would need to make sure that the 
send and receive objects agree on the form of the 
data being transferred. 


TIME FOR AN UPDATE 

Most light devices, for example NeoPixels, are easy 
to use. You just tell them the colour you want, and 
they light up with that colour until they are given a 
new colour value. However, the Pixie light used in the 
flashlight needs to be repeatedly told the colour to 

be displayed, otherwise it will shut down. To achieve 
this, we add an update function to the PixieLight 
class. This is called regularly by BLE_receiver and will 
refresh the colour settings on the light when required. 


or no colours being displayed. We are sending ‘raw’ def update(self): 
Figure 4 @ data values like this because Bluetooth limits the size millis = time.ticks_ms() 
a of data packets. If we were sending the data over a interval = time.ticks_diff(millis, self.last_ 
wrapped around the network connection with more capacity, we could update_ticks) 
en use JSON (JavaScript Object Notation) to encode the if interval>self.update_tick_interval: 
the potentiometers data. JSON data includes a description of the data. self.render() 
self.last_update_ticks = millis 
{ 
"red_byte":0, The PixieLight class contains two member values: 
"green_byte":255, last_update_ticks and update_tick_interval. 
"blue_byte":® The last_update_ticks value contains the time in 
} milliseconds since the light was refreshed. The 
update_tick_interval value contains the interval 
The JSON encoded data above could be used between refreshes, in our case 200 milliseconds. 


to send the colour bright green to a JavaScript 

application. The name of each value is part of the 

data, making it easy to understand what is being 

sent. However, this message contains many more 

bytes than the three that are used by the light. With 
= low-capacity connections such as Bluetooth, we 

must make sure that both sides of the conversation 

agree on the data format. 

If you want to use the incoming data to control 
a different device, you can swap PixieLight for a 


CIRCUITPYTHON VS MICROPYTHON 


The code to control the original light was written using CircuitPython. However, at the 
time of writing, there are no Pico W Bluetooth libraries available for CircuitPython. 
Bluetooth connections are presently only supported by MicroPython. CircuitPython 
and MicroPython are very similar; they differ mainly in the availability of different 


libraries for specific devices. If you are serious about becoming an experienced Figure 5 & 

embedded developer, you should aim to be familiar with both implementations. The N a onra 
oe . : Jahil : with a small hole and then drill it out to fit. 

author originally chose CircuitPython because of the availability of a library for the meake earo core cAn 

Pixie lamp he was using. However, he was able to convert this library to MicroPython mistakes with the initial hole position. It also 

and then use MicroPython for this project. produces a nicer finish to the hole 
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Each time update is called, it gets the current time and purchased for this project. The author really likes 
then works out how many milliseconds have elapsed strawberry milkshake. 

since update was last called. If the interval is greater Figure 5 shows the controls fitted to the top of 
than update_tick_interval, the render function is the milkshake box. The switch was pushed through 
called to display the lights and keep the Pixie shining. the top of the box and then connected to the Pico 
and the battery. The Pico and battery holder were 
then secured to the inside of the box using adhesive 
Velcro. The resulting box looks quite pleasing (at least 
to the author), and the device inside works well. 

It would be possible (and indeed quite easy) to 

use the same technique to create other Bluetooth- 
connected devices. O 


FINAL ASSEMBLY 

Figure 4 shows the wiring for the light controller. It 
was first built on the desk and tested before being 
transferred to the case. The power is controlled by 

a push-button which is connected in series with the 
battery box. Once the circuit had been tested, it was 
then ready to be put inside the case, which was a 
box of milkshake which was in no way specially 


Below 

Only a good idea 
if your device 
doesn’t use radio 
communications 


En a 


ET rated ® 


The original = 


AL 


CURIOUS 


BOXING CLEVER 


The author likes the idea of upcycling, where a project 
reimagines an existing product. The controller for the light 
is fitted inside a box that previously contained milkshake 
powder. Here are some tips for upcycling. 


LY STRONG MINTS 


e Don't use metal boxes for devices that contain 
radios. The author's first choice of box was a tin 
that had previously contained mints. After a bit of 
thought, this was abandoned as a bad idea, but 
the mints were delicious. 


With Other 
Natural Favors eg P E P P E 


e Use longish connecting wires. The author used ° 
to take great pride in how all his wires between 
components were exactly the right length. This, 
while aesthetically pleasing, did tend to make 
fitting the components into the box much harder 
and more likely to cause damage. Longer wires 
give a lot more leeway in case construction and 
can be safely tucked inside the case. 


Use heat-shrink tubing to cover connections 
and make sure that connections have physical 
integrity. If you are soldering a wire to a terminal, 
make sure to hook the wire through a hole to give 
the connection physical strength, and then use 
solder to hold the wire in place and provide the 
electrical connection. Then cover the whole 
thing with heat-shrink tubing. This makes 
everything look a lot tidier and means that loose 
wires won't cause problems. This is particularly 
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e Don't always twist all the connecting wires 


together to make a wiring harness. This sounds 
counter-intuitive, but it does make sense (at least 
to the author). If you have ten wires going to a 
component, you could twist them all together to 
make a single cable. However, because all the 
wires will be different lengths, this means that the 
weight of all the wires may end up being borne 
by the shortest cable connection, which will 

then break. If all the wires are separated, each 
connection will only have to support the weight 
of one wire. If you really do want to group cables 
together, make sure they are supported inside 
the case. 


Construct and test your circuit outside the case. 
Itis very hard to check connections once you 
have put them in a box. Create the entire circuit 
and test it first. Then put it in the box. 


important if you are using a metal case, as it 
prevents signals shorting. 


Use connectors with components that fit into 
the case from the outside. Some components, 
for example, some switches and lights, are fitted 
from the outside of the case and then secured 
internally. In the light control, the push-button 
power switch is fitted into the case from the 
outside, and so it is connected using push-fit 


connectors rather than being connected directly. 


Don't stick components into your case using 
a permanent adhesive. The author is a big fan 
of self-adhesive Velcro, which can be used to 
hold processors and batteries in place. The 
components are held firmly, but they can be 
removed if required. 


HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc. 
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Phenomenal 
Raspberry P1 _ 


a o 
he uses for Raspberry Pi are endless - 
| and, now Raspberry Pi 5 is here, you’re 
all doubtless looking forward to your 
next build. 


Here is a selection of amazing projects using 
_— - all Raspberry Pi computers. We’ve categorised 
this selection, drawn mainly from the past 
year’s issues, by theme from space and scientific 


sensing and investigation to photography, music 
and art, AI, robots, and retro. 


Get clued in about Raspberry 


Pi projects worth pursuing with Whether you’ve just taken delivery of a 
7 A shiny new Raspberry Pi 5 or are using a Pico 
your guide Rosie Hattersley or Raspberry Pi 400, there’s plenty of project 


inspiration to be found in the following pages, 
almost all of it created by makers, tinkerers and 
readers of The MagPi magazine! 

Check out these examples, and don’t forget 
to show us your own creative versions on 
Threads, Facebook, Instagram, or Mastodon, 
tagging #MagPiMonday. 
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an 


Retro Gaming 
with Raspberry Pi 


Retro gaming 


magpi.cc/retrogaming 


& computing 


Our very own guide 
to old-school gaming, 
complete with project 


Pico Pocket Gamer ideas and amazing 


builds to emulate. 


` magpi.cc/pocketgamer 


A straightforward strategy is at the heart of this great Pico- 
based game, for which maker Grgo Mariani created a custom Lunchbox Arcade 
circuit board (but stresses that this bit is optional) and added 
a 320x240-pixel display and five simple switches. We love this 
project's achievable simplicity. 


magpi.cc/lunchboxarcade 


Tin lunchboxes are nostalgic in their 


á : own right. They're also ideal for 
x sae 
jt JZ KON f md Ct adding speakers and decals for your 
Ji J VIE p own mini arcade. 


NB100 Cyberdeck 
( magpi.cc/nb100 


Upcycling old tech using 


Raspberry Pi is marvellous fun, as e e Fancy Octopus Arcades 
this repurposing of an Amstrad RetroPie samıng A 

( magpi.cc/octopusarcades 
A4 notepad with a split keyboard retropie.org.uk 


and 8.8-inch widescreen display New Yorker Shonee Strother's 


shows. Retaining nothing but RetroPie provides a simple, 
software-based way of getting to 


enjoy old favourites on any version 
of Raspberry Pi you choose, with six-year-old son and packed with 
with 2020s processing chops. Á . i incredible detail. 

or without a classic console case. 
Half the fun is repurposing an old 
console or customising a biscuit 
tin to house your brand-new 


gaming device. 


amazing custom-built RetroPie 


the 1980s case, it's now a fully arcades are co-designed by his 


functioning Cyberdeck computer 
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Raspberry Radio 
( magpi.cc/121 


A detailed tutorialin The MagPi 
magazine issue 121 explains how 
to put together a Raspberry Pi Pico 
Radio with stations and podcasts 
tailored to your own interests and 
musical tastes. The Display-O-Tron 
LED screen will even show news 
headlines - or you can have them 
read aloud. 


Mini PC 


( magpi.cc/minipc ) 


This miniature PC started out as 

a Bluetooth speaker. Seeing its 
resemblance to a small desktop 
computer, owner Carter made 

the vision a reality with the aid 

of Raspberry Pi 3B, a BlackBerry 
keyboard, and some 3D printing. It 
runs Raspberry Pi OS and could be 
replicated using Raspberry Pi Zero. 
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\ C, and Scratch. Kids will 


Clamshell BlackBerry Cyberdeck 


magpi.cc/diycyberdeck 


Combining an iconic early smartphone keyboard 
with the gorgeous HyperPixel 4.0 display via the 
incredibly useful GPIO pins of a Raspberry Pi 4, 
the BlackBerry Cyberdeck provides powerful 
computing power in a pocket-sized form. The 
icing on the cake is maker Michael's beautifully 
designed and laser-cut plywood case. 


Team Pinball 


magpi.cc/teampinball 


Pinball wizardry has also been fascinating, 

for the intricate table designs as much as 

the flipper-based play. Wales is home to the 
UK's only pinball factory, where it's a labour of 
Raspberry Pi CM3-based Love for its designer- 
maker team. Their retro game, The Mafia, “brings 
the player back to Chicago and the 1930s 
Prohibition Era with gangsters, casinos, and of 
course, a bank to rob!” 


(€ Upcycling old tech 
using Raspberry Pi_ 
is marvellous fun 99 


Unity 3D 


magpi.cc/unityintro 


With guidance on how to 
create characters and your 
own 3D adventure game, 
Unity 3D offers lots of 
Raspberry Pi-based coding 


> eme 
fun and an alternative to an : 
the better-known Python, © 


respond to the bright 


. Introduction 
visuals and the chance to = 
create their own worlds, un 

You will make 


collecting experience 
badges along the way. 


M 


Heavy Pan Tilt System 


magpi.cc/heavypan 


Astrophotographers often find it hard to create a setup robust enough 
to take a hefty digital SLR camera and have it pan smoothly across the 
night sky without it juddering, or losing either focus or the object in the 
viewfinder. Maker Vito put together his own mechanical designs and 
software to automate object tracking, with Raspberry Pi 4 providing the 


critical stepper motor controls and OpenCV libraries for computer vision. 


See the incredible results at magpi.cc/vigasanyt. 
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EPIC Satellite 
( magpi.cc/epicsatellite 


NASA shares daily photos from its 
Deep Space Climate Observatory 
including its EPIC (Earth 
Polychromatic Imaging Camera) 
which is trained on the sunlit 

side of the Earth. This gorgeous 
project by Matt Gray shows off 


these visual treats wonderfully on 
a HyperPixel Round Touch Display, 
having pulled them into view 
using NASA's Blue Marble API and 
Raspberry Pi Zero W. 


astropi.org 
— 


Mini Mars Rover 


Lightweight but durable materials 
and a simple design that others 


While on the International Space Station, 
astronauts undertake experiments on Raspberry 
Pi computers devised by dozens of groups as 
part ofthe annual Astro Pi challenge. Read about 
teenagers’ attempts to measure variations in the 
can easily replicate were the 
principles behind this wonderful 
Pico W-based Mars rover, inspired 
by a workshop at Belgium's 
CubeSat Summer School. Maker 
Nikodem designed everything in 
CAD himself, then 3D-printed it 
and set up the MicroPython code 
to control his mini marvel. 


strength of magnetic north, climate change in 
inaccessible locations, and much more. 


Young people aged 19 and under can enter 
Astro Pi and Mars Mission between now and 
the end of the year. Entry packs will be sent out 
to schools, code clubs and groups of friends, 


regardless of where in the world you live. 
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Chip Bipedal Robot Companion 


magpi.cc/chipbiped 
m 


Having a chip on your shoulder is not 

usually indicative of Zen-like happiness, but 
accomplished robot builder Kevin McAleer 
(kevsrobots.com) is more than content with his 
“cute interactive humanoid pal.” The shoulder- 
percher has a Raspberry Pi RP2040 board inside 
in the form of a Pimoroni Servo 2040, chosen 
for its 18 servo sockets, and senses the world 
through an ultrasonic range finder. 


RockyBorg 


( magpi.cc/rockyborg ) 


PiBorg's RockyBorg is an enduring 
favourite at Raspberry Pi Towers. 
The three-wheeler corners 

like a dream and is capable of 
magnificent speeds. Two 180 rpm 
motors on the rear provide forward 
momentum, while a servo tilts 

the robot's body of the robot to 
change direction. This £99 kit 

just needs a Raspberry Pi and HQ 
Camera to complete. 


K-9 


magpi.cc/kg 


! 


True Whovians will approve of the fact that maker/tinkerer 

Fitz used whatever he had to hand when creating The Doctor's 
famous companion and adapting the schematic shared by 
other fans: magpi.cc/kgpdf. K-9 features various mechanisms 
to defend himself, but also uses Al to sense friends nearby - at 
which point, the camera in his head takes a quick snap that K-9 
prints out through his mouth and presents to his new buddy. 
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ClippyGPT 


magpi.cc/clippygpt 
— eS 


Microsoft's annoying 
Windows assistant 
gets a seemingly 
sentient makeover 
with this Raspberry Pi 3B+ character that uses 
Adafruit’s Cricket HAT to connect up various servos, 


motors and solenoids to create a chirpy Clippy who 
chats back. 


ante 


( magpi.cc/lovemachine , 


FEATURE | MägPi MENR 


Love Machine & Olga 


Among the most endearing Raspberry Pi 
projects we've covered recently are two by Will 
Lahrs and his creative team at Kakapo Labs. 
First, they designed the smooth-talking Love 
Machine which uses Al and ChatGPT to connect 
with passers-by and engage them in flattering 
WhatsApp banter. They then went on to create 
Olga The Fortune Teller who shares much of the 
original project's Pico W-enabled interaction and 
prints out fortunes on a Zebra thermal printer. 


Photon DIY Incident Meter 


magpi.cc/photonlight 
m 


Good photographs need good lighting as well 

as an interesting subject and framing. This Pico- 
based light meter, coded by our friends at Veeb.ch, 
using MicroPython helps you get the balance right. 


Digital Toy 
Camera 


( magpi.cc/digitaltoycam ) 


Despite declaring digital sensors 
“a pain,” maker Volzo designed 

a camera that uses the 5 MP 
Raspberry Pi Camera Module 


Instant 
Photo Printer ; 


| magpi.cc/cameraprojects | 


You can easily print out your best 
snaps using a thermal printer housed 
in a cardboard box. Use any Raspberry 


POP 360-Degree 
Camera 


magpi.cc/popcamera 


A virtual reality 
camera in a Flip video 
camera-sized form, this CM4- 


V1 lens and Raspberry Pi Zero Pi and add based VR videocam is impressively 
to capture Lomographic photos large push- straightforward to use. Although the 
that are far more interesting, and buttons to visuals are blockier than we'd like, 
quirky, than those you get with a initiate the it's another example of Raspberry Pi 


boringly efficient smartphone. print process. pushing technological barriers. 
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Wire loop game 


( magpi.cc/wireloop ) 


© . Making use of the Scratch visual 
i ə o Coding interface, this fun buzzer game 
takes you through creating circuits 
with lights, jumpers, and sounds. It 
will even display a scoreboard to 
encourage healthy competition. 


Raspberry Pi Pico Advanced Kit 


magpi.cc/picoadvkit 
m 


Pico owners will get hours of N Bam 
enjoyment from the excellent £29 box 

of electronics, all aimed at extending = ad Ei EL a & . JE 
the way you use your low-cost 

Raspberry Pi using sensors, lights, and 
buzzers. There are 32 projects detailed r: 
and the kit even includes elements to 

get you started making robots! 


CamJam EduKit Open-source Gamma 


Spectrometer 
ga o% i | magpi.cc/gammaspec | 


This enduringly E LAA This Pico-based radiation detector 

popular £6 kit DTR 6 is smaller and cheaper than a 

contains everything En É standard Geiger counter. Sensitive 

you need to get stuck into electronics enough to detect even low levels 

and devising your own science of gamma radiation, it uses spectrometry to determine the 
projects with Raspberry Pi. It literally composition of a radioactive material and its approximate age. 


contains bells and whistles (well, 

buzzers and lights) along with jumper 2 

leads, breadboards, and clips. Ohsillyscope 

` magpi.cc/ohsillyscope 
Rudol h The Red Musician Thomas created a Raspberry Pi 
y 
oscilloscope with an LED matrix to show 
; Nose Reindeer p 


the waveforms created by his electric 
magpi.cc/rudolph guitar. Marvellous and suitably OTT! 


Rob was charmed 
by this workshop 
aimed at getting 
newbies into programming, while 
assembling a plywood Rudolph 
complete with flashing red nose, a 
leg that moves, and enough festive 
lights and a star to keep even our 
resident Christmas obsessive happy. 


LEGO Submarine 4.0 
( magpi.cc/legosub4 A- 


Propellers provide buoyancy and motion in 
| this stunning submersible. An air compressor 
| adjusts the water displacement and a piston 
ballast governs the sub's gravitational heft. 
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Raspberry Shake 
raspberryshake.org 


Raspberry Shake provides 
an ideal kit for monitoring 
earth tremors both natural 
and man-made. You can 
see real-time seismic 
activity from volcanoes, 
thunderstorms, and 
tsunamis, but also log 
vibrations from lorries 
rumbling down your street 
orthe crowd excitedly 
enjoying a jam-packed gig. 


Flight Tracker 
With Weather 


magpi.cc/flightweather 


Inspired by a simpler aircraft tracker 
on Reddit, maker Adam Paulson 
came up with one that also provides 
localised weather forecasts. The 


three-day forecast is shown on 

a rather lovely 64x32 RGB matrix 
display, thanks to an Adafruit 
Bonnet, while data comes from the 
FlightTracker API and everything is 
managed by Raspberry Pi 3B+. 


AuraLock Automatic 
Door Opener 


| magpi.cc/auralockdoor | 


Face recognition provides 


hands-free home access 
(good news if you're laden 
with groceries) with the 
help of Raspberry Pi 4 and 
camera, lock mechanism, 
and an Android phone. 
The mechanised wooden latch manoeuvres the deadbolt - 


no annoying PIN or fiddly keys are needed. 


Home automation 


magpi.cc/129 


We covered all manner of home 
automation options back in issue 129, 
highlighting how easily Raspberry 

Pi integrates with the likes of 

Apple's Homekit to control lights, 
robot vacuums, heating, and more. 
Download the issue to get started with 
voice assistants and smart sensors. 
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0) Bugg.xyz 
n ( magpi.cc/ecosystemmonitoring 


We've covered lots of Raspberry Pi- 
based wildlife camera setups in The 
MagPi. Bugg.xyz is used in forests 
from Norway to Borneo to listen 

in and establish ecosystem health 
according to the soundscape. You 
can conduct your own experiments 
using Raspberry Pi, an HQ Camera, 
and some simple garden tools 

by following Bugg founder 

Sarab's instructions (linked above). 


Pico Plant Waterer 


magpi.cc/plantwaterer 


Give your houseplants some loving 
care without having to bother your 
neighbours or kids to keep an eye 
on them. Simple moisture sensors 
either sprinkle your plants - or not - 
depending on whether the soil has 
dried out. Neat! 


NeoPixel Stairlights 


magpi.cc/neopixelstairs 


| 


The rainbow staircase in Lorraine Underwood's 
project sets off the lights particularly well, but it’s 
actually temperature sensing that triggers them. A 
perennial The MagPi favourite project, it works with 
any Raspberry Pi alongside Adafruit's NeoPixels to 
create a giant visual thermometer. 
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——= 


2) 


— 


experiments 


Night Clock 


\magpi.cc/sensehatnightclock | 


The Sense HAT is capable of all kinds of computing capers, but 
lends itself especially well to projects where you want to be able 


to get the gist of something without really trying. Lorna Jane's 
Night Clock Sense HAT coloured grid shows you whether it's 
night or day, so you can immediately decide whether to get up. 


FEATURE | MägPi MENR 


Disco Diva Dog Jacket 
( magpi.cc/cyberdogsaddle 


Robot maker Kevin McAleer kitted out his beloved dogs with 
light-up jackets using NeoPixels, then headed to Blackpool for a 
celebratory promenade. This innovative dog coat is not just about 
style; it's about ensuring the safety of his pets during night-time 
walks. Kevin's creation uses a Raspberry Pi to control the LED 
patterns, making the coat functional and fashionable. 


10 
R 


Wearable Tech 


Queen of wearable tech Sophie Wong 
put together this book for us featuring 
fantastic makes such as helmets, 
hoodies, and apparel - all featuring 
electronic elements. NeoPixels, 
individual LEDs, and a discreet power 
pack, along with a microcontroller 
such as Raspberry Pi Pico to add any 
clever time triggers are all you need. 


Mona Lisa 
Fluid Painting 


magpi.cc/monalisafluid 


Showcasing the potential of CNC Plotter 


fluorescent fluid in medical 

applications, this mesmerising ( magpi.cc/cncplotter ) 

liquid painting on a tiny chip was Fascinated by haw plotters 

work, maker Stratos Botsaris 

set about using an old scanner 
and printer and some G-code 
text files extracted via Python to 
create detailed A4 drawings. The 
Raspberry Pi-controlled device 
reads the text-based instructions 
and tells the stepper motors how 
to execute them. 


Raspberry Pi Beret 


magpi.cc/raspberrypiberet 


A Raspberry Beret was an early example 
of Pi-based wearable tech. The princely 
project has had a new Pi (power 
generation) update and gained a new 
audience of admirers on TikTok. A Pico W, 
addressable LED lights, and the effortless 
chic that wearing a beret conveys create 
an instant classic. 


captured in all its miniature glory by a 
Raspberry Pi HQ Camera. 
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Music & Media Projects 


Lo-Fi Orchestra 


A magpi.cc/makesound 
a_a 


The ‘Make sound with Pico’ article is well worth a look if you need 
some ideas of what you might make. Included alongside the DIY Trill 
guitar ( ) is the Lo-Fi Orchestra, in which multiple 
instruments controlled by Arduino and Raspberry Pi boards feature. 


PaperPi V3 


magpi.cc/paperv3 


The restful Waveshare e-ink display of this understated media 
player makes it a classy addition to your home décor. “Ideally, the 
screen would be easy to read from across the room, look great, 
but also fade into the room,” says maker Aaron, who uses it to 
show off phases of the moon, as well as photos, and occasionally 
plugs in a HiFiBerry DAC. 


PicoStepSeq 
It is el ose to ! magpi.cc/picostepseq 


Thirty Past Taking advantage of the RP2040's 
Four GPIO pins, pulse-width modulation, 
and movable UARTs, Tod Kurt 

used step switches (lever switches 
with LEDs) to create a sequencer 


— reminiscent of an 1980s classic synth. 
A super, geeky Pi project. 
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(( Extending the 
possibilities of 
Braille literacy for_ 
blind and partially- 
sighted users is no 
mean feat 99 


Magic Mirror 


Voted the number one greatest use 
of Raspberry Pi way back in issue 

50 of The MagPi, a magic mirror is 
still one of the most popular, not 
least because you can choose or 
create different frame options and 

it can easily be customised with 

info feeds, as well as blending in 
wonderfully with your décor. Follow 
PJ Evans's tutorial to create your own 
magic mirror your own way. This LCD 
Chalkboard version is a really great 
example (magpi.cc/lcdchalkboard). 


The Lost 
Sounds Project 


magpi.cc/thelostsounds 


We really like the low-tech approach 


to this project in which bird silhouettes Bristol Braille Canute 360 
emit their corresponding bird sound N . . 
when the electrical circuit is complete. ° _magpi.cc/bristolbraille_ 


The Raspberry Pi-based project only 

costs a few pounds to replicate, and is 
perfect for getting citizen scientists to 
notice their surroundings and show off 
their findings. 


Extending the possibilities of Braille 
literacy for blind and partially sighted 
users is no mean feat: community 
interest organisation Bristol Braille took 
eight years and a dozen iterations to 
bring the world's first multi-line Braille 
reader into being. This Raspberry Pi 
Zero-based device and its Raspberry Pi 
A 400-based sibling, the Canute Console, 
hugely extend reading options and 
digital library access. 
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ClipZin 


> EDAC » magpi.ce/clipzin » £4 (pack of two) 


FEATURES: 
Gold flash- 
plated 
contacts, 
surface-mount 
connectors, 
board retention 
clips 


DIMENSIONS: 
57 x 26 x 6 mm 


Pico clicks neatly and 
securely into place 
between two 20-way 
ClipZin connectors 


Verdict 


Should prove 
handy for Pico- 
based PCB 
prototyping and 
could also be 
used in 

final products. 


8 10 
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An easier way to connect Raspberry Pi Pico to PCBs. 


By Phil King 


manufacturers, along with advanced 
electronics hobbyists, ClipZin is a new way 
to connect a Raspberry Pi Pico to a PCB. 

Ever wondered why Pico has those castellated 
(bumpy) edges alongside the two strips of 20 GPIO 
pin holes? You can use these castellations - actually 
gold-plated half-holes - instead of the usual pins 
to connect Pico to other electronics. This kind 
of card-edge technology has long been used in 
computer design. 

While you could always just solder Pico’s 
castellations directly onto metal contact pads 
on the surface of another PCB, ClipZin has the 
advantage of being able to clip the board in and out 
at any point - ideal for when you’re prototyping 


A imed mainly at breakout/carrier board 


a design or want to later replace a standard Pico 
board with a Pico W. 


Clip in, clip out 

In practice, we found it extremely easy to clip a 
Pico onto a sample PCB fitted with a pair of surface 
mounted, 20-way ClipZin connectors. Just push 
Pico down and it clicks securely into place, held 

by individual springy pins that maintain a good 


m Just push Pico down and it 
clicks securely into place @ 


connection with each castellation. Small plastic 
retention clips on either end also help to keep it 
in place. 

Removing Pico from the ClipZin connectors is as 
simple as gently pulling one of the retention clips 
and lifting the board out. 

While a little more expensive than the alternative 
of using FlexyPins (magpi.cc/flexypins), ClipZin 
connectors benefit from being all-in-one (coming 
in 6-, 8-, 17-, and 20-way versions), making them 
far less fiddly to solder onto a PCB. Hl 


W Theconnectors' springy pins maintain a reliable connection 
with Pico's castellations 
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CM4 XGO-Lite 


O 


SIZE: 

250mm x 145mm 
x 170 mm while 
standing, 620g 


LIMBS: 

Four walking 
limbs and one 
gripper allowing 
for 15 degrees of 
movement, and 
three on the arm 


PROGRAMMING 
LANGUAGES: 
Blockly, Python, 
ROS 


BATTERY: 

2500 mAh lithium 
ion battery with 
120 minute life 


Verdict 


Avery impressive 
robot kit that 
while fine for 
beginners may be 
better suited to 
those already into 
robotics due to 
the price 


9, 10 


ot Dog Kit 


> Elecfreaks >» magpi.cc/em4xgo » £469 / $599 


A Compute Module 4-powered robot dog with five limbs and 
a huge amount of potential, Rob Zwetsloot takes it for a walk 


e’ve seen a small explosion of dog- 
W like robot kits over the past few years, 

although we cannot put a finger on 
what might have started it. Perhaps the cuteness 
of a four-legged pet is hard to resist when you can 
program it yourself, which brings us to the very 
powerful XGO line of robot kits. 

Unlike a lot of a robot kits, this one has metal 
construction throughout, making it chunky and 
weighty in the satisfying way quality technology 
can be. It also comes all pre-assembled so you 
won’t be bending any metal plates or doing any 
complicated wiring to get it working, like with 
other legged robots. 


It’s definitely a very well put together product, 
although it’s not the most stable looking 
robot we’ve ever seen. The price is also a little 
eyewatering, but we think the tech inside justifies 
it, especially if you’re looking for a more advanced 
bit of kit. 7 


M There are several bits 
of example code that 
illustrate the impressive 
features of the robot, such 


Smart dog as facial recognition Ø 


At its core is a powerful 
Compute Module 4, 
controlling the robot 
and allowing for 
reprogramming with 
custom code over a web 
browser - although you 
can also plug it into a monitor (or go a 
VNC route) if you want and program it 
the old-fashioned way. There are several 
bits of example code that illustrate the 
impressive features of the robot, such as 
facial recognition with the inbuilt camera, 
remote control, and more. There’s a full 
breakdown of the Python commands on 
the quite detailed documentation over at 
magpi.cc/xgodocs, and it even has a block 
code editor for people not quite up to speed 
on Python. 


W The box comes with 
some coloured balls 
that you can program 

XGO to pick up 
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Learn circuits 
with Raspberry Pı 


Start building electronic circuits with the help 
of these resources, By Phil King 


CamJam EduKit 


CamJam 


Price: 
From £6 


magpi.cc/camjamkits 


Raspberry Pi’s 40-pin GPIO 
header is its ‘superpower’, 
enabling you to connect not only 
HATs and other breakout boards, 
but also your own custom 
electronic circuits. 

If you’re looking for a low- 
cost way to learn how to begin 
building circuits, you can’t 
go wrong with the CamJam 
EduKit series. The first of these, 
EduKit #1, has everything (bar 
a Raspberry Pi) you need to get 


started: a 400-point breadboard, 
three LEDs (red, yellow, green), 
push-button, buzzer, resistors, 
and a selection of jumper wires 
to connect components to each 
other on the breadboard and to 
Raspberry Pi’s pins. 

Best of all, online worksheets 
guide you through a series of 
electronics projects, coding 
them with Python on Raspberry 
Pi. Once you’ve mastered the 
basics of circuits, you might 


well want to explore adding 
sensors (including temperature, 
light, and IR) with EduKit #2, 
and/or build a simple two- 
wheeled robot with EduKit #3. 7 


Get kitted out 


84 | magpicc | Learn circuits with Raspberry Pi 


Start building circuits with these electronics kits 


RASPBERRY PI ULTIMATE KIT 
Canakit's electronics kit lives up 

to its name and also includes a 
Raspberry Pi 4, 3+ or 3 and quick- 
start guide. A full-size breadboard 
is complemented by an interface to 
extend Raspberry Pi's GPIO pins. 

> magpi.cc/canakitultimate 


MONK MAKES PROJECT BOX 1 
This kit includes LEDs, a thermistor, 
phototransistor, switches, and 
handy GPIO pin identifier overlay - 


everything you need to get started 
with the projects detailed in a 46- 
page downloadable PDF guide. 

> magpi.cc/projectbox1 


WAVESHARE SENSORS KIT 
Enable your Raspberry Pi to sense 
the world around it with this 
selection of 13 sensors - as used 
in our Sensory World tutorial series 
(issues 111 to 114) - including gas, 
moisture, and tilt. 

> magpi.cc/wavesensors 
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Recommended 


Learn Electronics 
with Raspberry P1 


reading 


Stewart 
Watkiss 


Price: 
£40 


magpi.cc/ 
learnelectronicsbook 


You may recognise author 
Stewart Watkiss from the series 
of electronics tutorials he’s 
written for The MagPi, starting 
in issue 127 and covering 
everything from the basics 
to creating a Pong game and 
controlling a model railway. 
His book, Learn Electronics with 
Raspberry Pi, guides you step- 
by-step through the creation 
of a variety of electronics and 
hardware projects using a 
Raspberry Pi. These include 


mastering input and output from 


the GPIO pins, programming in 


Python, and reading light and 
PIR sensors. 

Of particular interest is the 
chapter on making your circuits 
more permanent by soldering 
components to stripboard or 
protoboard. The final chapter 
looks at designing your own 
custom circuits - using the 
Fritzing tool (fritzing.org) to 
create schematics which you 
could even turn into a PCB 
(printed circuit board). 7 


Books to help you 
learn more about 
circuits 


BEGINNER'S 
GUIDE TO 
READING 
SCHEMATICS | 
A proper | 
schematic ly 


diagram 

offers a much clearer, 
high-precision view of circuit 
designs, once you understand 
the symbols used. Stan 
Gibilisco's book explains how 
to read schematics and design 
your own for projects. 

> magpi.cc/readschematics 


Wokwi 


CodeMagic 
Price: 

Free 
wokwi.com 


Sometimes you may want to test 
out a circuit design before you 
go ahead and build it, which is 
where a circuit simulator comes 
in handy. There are several 
available online, but Wokwi is 


free and simple to use. It covers 
Raspberry Pi Pico among other 
microcontrollers and there’s a 
variety of examples and shared 
user projects to try out, along 
with starter templates for Pico. 

In the Simulation window on 
the right, you can add all sorts 
of electronic components - 
including sensors and motors/ 
servos - and wire them up 
(with or without a breadboard) 
to Pico’s pins. The left-hand 
window is used to code your 
project, in MicroPython or 
C/C++; just run it to see if it 
works correctly. If so, you can 
download the project code to use 
on Pico for real. Hl 


Learn circuits with RaspberryPi | magpi.cc | 85 


RASPBERRY PI COOKBOOK 
4TH EDITION 

Simon Monk's 650-page tome 
is an all-round Raspberry Pi 
user and programming guide 
that includes several chapters 
dedicated to connecting 
electronics such as LEDs, push- 
buttons, and sensors. 

> magpi.cc/rpicookbook4 


GET STARTED WITH 
MICROPYTHON ON 
RASPBERRY PI PICO 

This official Raspberry Pi Pico 
guide book features step-by- 
step guides on building a range 
of circuits and programming 
them in MicroPython on the 
powerful microcontroller board. 
> magpi.cc/picobook 
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Y Excellent projects are 
shown off at the meetups 
- we wonder if this one 
can beat captcha 


86 | magpicc | Nai-Wen Hsu 


Nai-Wen Hsu 


Taiwanese Raspberry Pi reseller and Raspberry Pi community 
organiser, you can't miss Nai-Wen in the Taiwanese maker space 


> Name Nai-WenHsu | > Occupation Raspberry Pi reseller 


> Community role Advocate | > URL piepie.com.tw 


hile the Raspberry Pi 
W community spreads 
across the globe, each 
country has its own unique 
community with its own 
events and ideas. Taiwan is 
no different, with the founder 
of the Taiwan Raspberry Pi 
Community also an Approved 
Reseller of Raspberry Pi. 
“My job is to promote and sell 
Raspberry Pi, provide Raspberry 
Pi-based solutions, and design 


Raspberry Pi educational 
courses,” Nai-Wen tells us. 


What is your history 

with making? 

I studied manufacturing 
technology and computer 
engineering in college and 
graduate school respectively, 

so I am familiar with program 
development and processing of 
various materials such as metal, 
wood, and acrylic. 


Since coming into contact with 
Arduino in 2009, I have been 
using MCU and SBC combined 
with mechanical structures to 
solve problems in small projects. 


When and where did you learn 
about Raspberry Pi? 

In July 2012, I was looking for 

a small computer for a power- 
saving project and bought a 
Raspberry Pi 1 Model B. The 
first one was 256MB. The goal 
of the project, at that time, was 
to monitor the flow of people 
and adjust the air-conditioning 
settings according to the people 
present to achieve energy saving. 


What is it like to be a maker 

in Taiwan? 

Because the land in Taiwan is 
relatively small, most makers 
also solve small problems. 

If makers in Taiwan want to 

be influential, they can first 
establish a small community for 
promotion. If the government 
finds it suitable and adopts it, 

it will have more influence. For 
example, the PiM25 air pollution 
detection box I cooperated with 
Academia SINICA has more than 
4,000 monitoring points, and can 
be drawn into an air pollution 
map to assist government 
decision-making. 


| started a meetup and established 
a community in 2013 to promote 


Raspberry Pi 


In addition to promoting 
PiM25 AirBox in Taiwan, I also 
go to other countries to share 
related experiences [such as 
Hong Kong]. 


How did the meetups start? 

I started a meetup and 
established a community in 2013 
to promote Raspberry Pi [and it 
exists to this day]. 

At that time, people were very 
interested in what the Raspberry 
Pi could do, so I hosted a meetup 
every one-to-two months, each 
with a different topic, such as 
GPIO, cameras, robots, IoT, mass 
production manufacturing, etc. I 
invited friends who use Raspberry 
Pi for projects to share their 
experiences. My own code name 
in the community is ‘sosorry’, 
and I share different technologies 
at almost every meetup. 


What is your favourite thing 
you’ve made with Raspberry Pi? 
ThermalPi is my favourite 
project. ThermalPi is a solution 

I designed to detect human 

body temperature for COVID-19. 


Mägpi 


This energy-saving project 
was one of Nai-Wen's first 
Raspberry Pi projects 


ThermalPi is used 

around Taiwan to check 
temperatures of people 
so COVID can be detected 


It features the use of an RGB 
camera and a Thermal Camera, 
and can accurately detect various 
objects after dual-camera 
calibration. It is widely used 

in schools and government 
agencies, and some companies 
have adopted it and mass- 
produced it into products. 

I also shared the technical 
details of the ThermalPi project 
at PyCon Taiwan 2020, including 
the principles of thermal imaging 
cameras, how to use Raspberry Pi 
to read, dual camera calibration 
and temperature measurement 
applications, etc. 


A big turn out for the Taiwanese Raspberry Pi community 


Nai-Wen Hsu magpi.cc 87 


MS Mägi | THIS MONTH IN RASPBERRY PI 


M P 
[| Kevin McAleer @ Robot Maker 
Yan à : 
@themagpi this weekend I installed the Pi 5 into Bubo-2T! It's 
happily running on a battery pack too 


Amazing projects direct from social media! 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend. Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. 
Here’s a selection of some of the awesome 
things we got sent this month. Remember to follow 
along at the hashtag #MagPiMonday! Hl 


01. Raspberry Pi 5 robotics has begun and it's 
not even out yet 


02. Arobot-heavy month, we love to see all 
hese automatons 


03. Avery cool robot, it reminds us of the one 
in Jedi Survivor 


04. Raspberry Pi Pico is still a great controller 
for robots 


05. If you're getting interrupted during video 
calls, a little notifier can be a lifesaver 


06. Acamera that specifically reads QR 
des i t idea - perh NFC - 
er e als oea = pernapsah i.) Edgardo Peregrino £ 
“ Not shown but my robots are being run by one single 
07. We're calling this a rave in the box. Who application using Ansible 
has a Ministry of Sound CD? 


08. Do, Re, Egon, let's light ‘em up 


Reply Hide 
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Mägpi 


A dan.makes.things 


‘@ I've been building this guy! 


johniblue 


© First Robotics Competition team Pike RoboDevils 1018 picked up several 
Experiential Robotics Platform kits (XRP) that have a Pico W - see 


We are using them to help students get started programming robots on a 
simple platform before diving into the National Instruments roboRIO 


(L) Pater Practicus 


@themagpi #VISI (Video-call Interruptibility Status Indicator) 

prototype now has a #lego mount for attaching to laptop screen. 

The #raspberrypi Pico is powered by USB cable from the 

MacBook. #MagPiMonday on #mastodon @themagpi Hello #MagPiMonday, | know I'm late. But | was still 
waiting for Monday on the dark side (former Twitter). I'm 
currently playing around with my Tiny Useful Sensor and 
@Raspberry_Pi pico. A small camera sensor that can read QR 
codes. 


Top fan 
Jason Brett 
This is a prototype of an audio project my students will 
build this fall. It uses an XY-P40W Bluetooth audio 
receiver with a 40W Class D amplifier, and filters the Class ee ee RPA 


D signal to get a classic analog audio signal. It uses an op Halloween 
amp and RC filters to... See more 


Reply Hide 
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Community and official events in the wild 


e showed some images from the 

Melbourne Meetup last month but, 

this time, the meetup was a bit 
more special, allowing people to experience 
Raspberry Pi 5 before it was even out! You can 
find out other events with a Raspberry Pi5 on 
our events calendar over on page 94. 


There were still room for other projects, 
like this Raspberry Pi Zero robot 


Free swag of excellent magazines 
always goes down well 


It's a Raspberry Pi 5 in the wild! 


This robot is not powered by Raspberry 
Pi 5 in the traditional sense 
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Other cool things we saw using Raspberry Pi this month 


Peter Anderton, who 
made the Gutter 
Probe project you can 
find on page 26, also 
sent us this handheld 
Raspberry Pi project 
he'd made. It was 
apparently a challenge 
he set for himself 
during Lockdown 

in 2020, and it looks 
pretty good. 


Is nineties nostalgia here? Has it been and gone? We're not sure, 
but this fun project styled after a classic late-1990s package 

PC is very small and employs Raspberry Pi. Although it does run 
Windows XP, which is a bit advanced for your Gateway. 


magpi.cc/mini90spc 


ree international shipping 
with checkout code: 


SHIP-FREE-INTL 


shop now at 
tiithydrometer.com 
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Raspberry Pi 5 projects 


I’m very excited by the news of Raspberry Pi 5 coming 
out, and really looking forward to getting mine. My 
mind is abuzz with ideas but I was wondering if you’d 
be able to propose any projects that make use of the 
new features? 


Chuck via email 


We’re as excited as you are, and we also have a load 
of project ideas in mind - check out this month’s 
features for some excellent ideas on where to get 
started! Features Ed Rob is really looking forward to 
checking out VR 
movie filming with 
Raspberry Pi, a 
project Ben Everard, 
Editor of HackSpace 
Magazine, is 
currently working 
on too. 

If anyone has any 
project ideas, or 
complete projects 
they want to share 
with us, don’t 
hesitate to drop us 
a line. 


A The latest Raspberry Pi OS brings with it some interesting 
updates behind the scenes, such as the switch to Wayland 


Booking Bookworm 


I read about the upgrade to Debian 12 (“bookworm”) for Raspberry 
Pi OS in your latest issue. I went over to the Raspberry Pi website 
to download it but could not see it. Is it not out yet? 


id Ausaqdsey 


Cole via Mastodon 


: Tracom N The date for Raspberry Pi OS Bookworm slipped a little to the week 
3 chinsas22 ya after The MagPi 134 came out but, as you read this, it is out now! It’s 
; also the version that you should be using for Raspberry Pi 5 when 


you get one, and 64-bit is included on Imager as well. 


> By the time you read 
this, Raspberry Pi 5 
will already be out 
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USA SPECIAL! 


6 ISSUES! 


Boia Se 


How does Priority Boarding work? What kind of 
subscription do you need, and will I get the code 
now or with my first issue? 


Nicole via Threads 


iS 


The officlal Raspberry pi Magazine 


You can get a Priority Boarding code - a code to 
pre-order Raspberry Pi 5 and be one of the first 
to get one - by subscribing to the print edition of 
the magazine. Within a few days, you’ll get a code 
which can be used on Approved Reseller sites. Get 
more info at magpi.cc/priorityboarding. 


Raspberry Pi 
PRIORITY BOARDING 


` m | 


ON 


We've reserved Raspberry Pi 5 boards 


„ OFFICIAL RASPBE— 
for The MagPi subscribers e7 


GET YOUR RASPBERRY PI 5 FIRST! 


magpi.cc/priorityboarding 


We're very excited to offer these codes to print subscribers! 


Mastodon 
Threads 
Facebook 
Email 
Online 
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Community 
Events Calendar 


Find out what community-organised Raspberry 
Pi-themed events are happening near you... 


01. Raspberry Pi Club @ Makespace 
Cambridge - Experience Raspberry Pi 5! 

5 Tuesday 31 October 

® Makespace Cambridge, Cambridge, UK 

> magpi.cc/rpc135 

Tuesday nights in the Makespace Classroom are 

Raspberry Pi, Microcontroller, and CAD Clubs meet-ups. 

Come and join fellow coding and computer aided design 

enthusiasts for an informal evening of tinkering with tech. 

Help is on hand to assist you with any problems. 


02. Pi Fawkes at HackWimbledon 

Experience Raspberry Pi 5! 
© Sunday 5 November 
® Wimbletech, London, UK 
> magpi.cc/fawkes135 
It's a very special HackWimbledon. We meet and make 
every fortnight, but Pi Fawkes Night (well, afternoon really) 
will be a festival of Raspberry Pi 5s on November sth. If you 
want to get a look at a Raspberry Pi 5 in the flesh, or if you 
want to hear how it's going, come along. If you're getting a 


Raspberry Pi 5, come and tell how you're finding yours. 
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03. Melbourne Raspberry Pi Meetup 

5 Sunday 5 November 

® Docklands Makerspace and Library, Melbourne, 
Australia 

> magpi.cc/mrpm135 

This meetup is open to everyone with an interest in 

electronics, robotics, home automation, 3D printing, laser 

cutting, amateur radio, high altitude balloons, space tech, 

etc. Makers are invited to bring along their projects and 

project ideas, and come connect with other makers. Get 

your questions answered, show off the work you are doing, 

and get support to resolve nagging issues. = 


FULL CALENDAR 


Get a full list of upcoming 
community events here: 


| magpi.cc/events 


04. Cape Town Raspberry Pi Jam 
Experience Raspberry Pi 5! 

© Saturday 2 December 

® CTV Training Centre, Cape Town, South Africa 

» magpi.cc/ctrpj135 

Cape Town's first Jam since lockdown! Learn about the 

new Raspberry Pi 5 and more. 


EVENTS | MägPi EEE 


RASPBERRY PI Where can you find 
Raspberry Pı next? 


> Next location Maker Faire Shenzhen 
> Where Vanke Design Commune, Shenzhen, China 
> When Saturday 11 November to Sunday 12 November 


AT MAKER FAIRE 


aspberry Pi is proud to partner 


with Raspberry Pi Approved | Maker Faire Shenzhen | 
Reseller Seeed Studio, to be at WHERE ARE 
Maker Faire Shenzhen for the first "THE MAKE 


iK 


time ever. Come and meet members of 
the Raspberry Pi team, learn about their 
latest products, and share what you’ve 
made with Raspberry Pi technology. 


magpi.cc/smf23 
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AYRE HONE OF TEN ŠŠ 


RASPBERRY PI 5 
CASES 


With a new Raspberry Pi 
comes a new and improved 
case - the official Raspberry Pi 
5 case has improved airflow 
and a fan to help keep the 
insides nice and cool. We 
have ten to give away. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/rpi5case 


Terms & Conditions 


Competition opens on 25 October 2023 and closes on 23 November 2023. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram, Facebook, Twitter or any other companies used to promote the service. 
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Remote control 
with Tiget VNC 
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Number 5 1s alive! 


Now what will we all make with it? 


atching Raspberry Pi 
W 5 come to life was an 
incredible process. From 


hearing about the initial designs, 
to seeing the problem-solving, and 
hearing clever solutions proposed 
by the incredible design team. 

On our part, there was the stress 
of making sure everything was ready 
for launch. And the fear of being the 
one to accidentally leak it and ruin 
the surprise for everyone. It’s been a 
real eye-opener. 

It’s not really real until this point 
though. When it launches and gets 
into the hands of our readers, and 
hey start to build stuff with it: 
hat’s when Raspberry Pi 5 becomes 
a real product. 

So, what are we all to do with 
this super-fast, packed-with- 
new-features, and ringing and 
singing full of bells-and-whistles 
new computer? 


t 
t 


Where to start? 

Like many new Raspberry Pi 5 
owners, my first port of call was 
Raspberry Pi OS Bookworm (magpi. 
cc/downloads). This is now available 
for download and offers a vast 
increase in speed. I’ve also been 
testing out the advances in retro 
gaming (expect a big feature on this 
soon). Early reports suggest a big 
leap forward for console support 
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By Lucy Hattersley 


along the lines of the PlayStation and 
GameCube era. Cloud Gaming from 
Games Pass is also an incredible 
experience (and a whole lot cheaper 
than buying an Xbox Series X). 

We’re also busy looking at the dual 
camera support and stereographic 
photography for 3D images. And, 


M Machine learning is 
another area where 
we're very keen to 
see what advantages 
the new, much faster 
CPU offers Ø 


we’ve mooted the idea of using two 
small screens for creating a virtual 
reality option (although this is very 
much in the ideas stage). 

Machine learning is another area 
where we’re very keen to see what 
advantages the new, much faster 
CPU offers. We’re waiting on an 
update to TensorFlow Lite to get 
things working, and are going to be 
all over image recognition projects. 

We're also waiting on the M.2 
drive, at which point we will be 
turning Raspberry Pi 5 into a server. 
So, there’s lots to talk about in the 
coming months! 


Over to you! 

That’s just the start! What we’re 
really looking forward to is what you 
all make with Raspberry Pi 5. Our 
readers always surprise us with the 
incredible things they make with 
Raspberry Pi products. Whether it’s 
live-action RGB lighting in a pole 
dancing club, automatic weeding 
machines for Japanese gardens, retro 
equipment repairs, or monitoring 
animals in the wild: the uses for 
Raspberry Pi are wildly varied. 

I was reminded of this while 
reading through our Handbook 2024 
(available now: magpi.cc/handbook). 
This collects all the best community 
projects, tutorials, and kits from 
the last year. It’s a tour-de-force 
of the best The MagPi readership 
has to offer - which is an incredible 
amount of variety and cleverness. 

I really can’t wait to see what you 
all make with Raspberry Pi 5. Here’s 
to 2024, and another year of 
Raspberry Pi-goodness. Hl 


Lucy Hattersley 


Lucy is editor of The MagPi and is 
currently putting this issue to press with 
an 8BitDo controller in her inbox, which 
is ready and waiting for a Raspberry Pi 5 
retro gaming weekend. 
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HiPi.io 


GHPI PRO 


— The new case from the HiPi.io team — 


Whine. 
z ain LAIT hit 


® Rapid tool-free assembly and disassembly ® Secure microSD card cover 

@ Large internal volume for HATs @ VESA mount support 

e Compatible with Pi 2/3/4 e Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

@ Passive & Active Cooling options @ Printed logo for your branding 


Available at these great Pi stores: 


s s bd NÝ 
Æ PiShop.us {rfPiShop.ca {*fPiShop.mx ÜePiHut Pı-Suor.chn Welectron. 


Contact your favorite Pi store if it’s not listed here 


HiPi.io 


PIKVM 


Manage your servers or 
workstations remotely 


A cost-effective solution for data-centers, 
IT departments or remote machines! 


PiKVM HAT 
for DIY and custom projects 


Pre-Assembled version 
e Real-time clock with rechargeable super capacitor ®OLED Display ®Bootable virtual CD-ROM 
& flash drive @ Serial console © Open-source API & integration ® Open-source software 


Available at the main Raspberry Pi resellers 
PIMO 


Score RPishopcz Welectron. (Jlektor RONI 


ELECTA 


? 


PıSnor.cn (zpinut EPiShop.us (# Pishop.mx 


Reseller suggestions and inquiries: 


wholesale@hipi.io 


